Talk:Main Page - Revision history

Matt at 08:00, 27 August 2019

2019-08-27T08:00:58Z

Jflopezfernandez: Replying to thread

2019-08-25T18:03:34Z

Replying to thread

Matt at 22:33, 9 August 2019

2019-08-09T22:33:12Z

Jflopezfernandez: /* Proposed Change: Quick Links */ new section

2019-08-09T19:52:24Z

Proposed Change: Quick Links: new section

Stevem: More edits trying for that new look

2013-05-31T13:02:50Z

More edits trying for that new look

Stevem: Reference guidelines

2013-05-31T12:55:06Z

Reference guidelines

Matt: Added reference to MAC codes

2013-05-30T18:54:26Z

Added reference to MAC codes

Stevem: Update with section headers

2013-05-30T17:59:49Z

Update with section headers

Matt: Added a tweak and my thoughts

2013-05-30T15:02:41Z

Added a tweak and my thoughts

Stevem: First draft

2013-05-30T13:39:04Z

First draft

New page

This [[Main Page]] really needs some work. Here are some initial thoughts on an overall organization:

* Administrivia
: Site guidelines, legal and admininstrative issues.
** [[Basic rules]], [[Commercial Product Disclaimer]], [[Contributions]], [[Copyright]], [[License]]

* Reference
: This section has the automagically generated man pages from the OpenSSL git repository, and similar "man" style reference documentation
** OpenSSL Manual Pages
*** [[Manual:Openssl(1)]], [[Manual:Ssl(3)]], [[Manual:Crypto(3)]], [[Documentation Index]]
** [[API]], [[Libcrypto API]], [[Libssl API]]
** [[FIPS mode()]], [[FIPS_mode_set()]]

* Usage (or Programming?)
: This section has discussions of practical issues in using OpenSSL
** Building from Source
** [[OpenSSL Overview]]
** [[Versioning]]
** [[Compilation and Installation]]
** EVP
:: Programming techniques and example code
:: Use of EVP is preferred for most applications and circumstances
*** [[EVP Asymmetric Encryption and Decryption of an Envelope]]
*** [[EVP Authenticated Encryption and Decryption]]
*** [[EVP Symmetric Encryption and Decryption]]
*** [[EVP Key and Parameter Generation]]
*** [[EVP Key Agreement]]
*** [[EVP Message Digests]]
*** [[EVP Key Derivation]]
*** [[EVP Signing and Verifying]]
** Low Level APIs
:: More specialized non-EVP usage
*** [[Diffie-Hellman parameters]]

* Concepts and Theory
: Discussions of basic cryptographic theory and concepts
: Discussions of common operational issues
** [[Base64]]
** [[FIPS 140-2]]
** [[Random Numbers]]
** [[Diffie Hellman]]
** [[Elliptic Curve Diffie Hellman]]

* Internals and Development
: This section is for internal details of primary interest to OpenSSL maintainers and power users
** [[Internals]]
** [[Code Quality]]
** [[Static and Dynamic Analysis]]

* Miscellanous

← Older revision		Revision as of 08:00, 27 August 2019
Line 173:		Line 173:
	::		::
	:: -- [[User:Jflopezfernandez\|Jflopezfernandez]] ([[User talk:Jflopezfernandez\|talk]]) 18:03, 25 August 2019 (UTC)		:: -- [[User:Jflopezfernandez\|Jflopezfernandez]] ([[User talk:Jflopezfernandez\|talk]]) 18:03, 25 August 2019 (UTC)
		+
		+	::: No - just do it. You've discussed it here. I think its a good idea, and no one else objects- so go for it.
		+	::: --[[User:Matt\|Matt]] ([[User talk:Matt\|talk]]) 08:00, 27 August 2019 (UTC)

← Older revision		Revision as of 18:03, 25 August 2019
Line 166:		Line 166:
	: Wow - yeah. That looks great to me.		: Wow - yeah. That looks great to me.
	: --[[User:Matt\|Matt]] ([[User talk:Matt\|talk]]) 22:33, 9 August 2019 (UTC)		: --[[User:Matt\|Matt]] ([[User talk:Matt\|talk]]) 22:33, 9 August 2019 (UTC)
		+
		+	:: Do you think it's okay to make the change? There haven't been any objections,
		+	:: but I'm not sure what the procedure is for making changes like this. I think
		+	:: it's substantial enough to merit some kind of review process since it's the
		+	:: main page, but like I said, I don't really know.
		+	::
		+	:: -- [[User:Jflopezfernandez\|Jflopezfernandez]] ([[User talk:Jflopezfernandez\|talk]]) 18:03, 25 August 2019 (UTC)

← Older revision		Revision as of 22:33, 9 August 2019
Line 163:		Line 163:

	-- [[User:Jflopezfernandez\|Jflopezfernandez]] ([[User talk:Jflopezfernandez\|talk]]) 19:52, 9 August 2019 (UTC)		-- [[User:Jflopezfernandez\|Jflopezfernandez]] ([[User talk:Jflopezfernandez\|talk]]) 19:52, 9 August 2019 (UTC)
		+
		+	: Wow - yeah. That looks great to me.
		+	: --[[User:Matt\|Matt]] ([[User talk:Matt\|talk]]) 22:33, 9 August 2019 (UTC)

← Older revision		Revision as of 19:52, 9 August 2019
Line 88:		Line 88:
	I like it - it brings the interesting content right up front. It probably needs to have some top and tail text to describe what this wiki is for, and how to contribute. I added a link to the Elliptic Curve Cryptography page above		I like it - it brings the interesting content right up front. It probably needs to have some top and tail text to describe what this wiki is for, and how to contribute. I added a link to the Elliptic Curve Cryptography page above
	--[[User:Matt\|Matt]] 15:02, 30 May 2013 (UTC)		--[[User:Matt\|Matt]] 15:02, 30 May 2013 (UTC)
		+
		+	== Proposed Change: Quick Links ==
		+
		+	I'm proposing a change of the quick links section to use the wikitable syntax. This is the current version, but I can modify the styling as required, like changing the background and removing the border to look as if we just moved the old table to the center, if anyone prefers that.
		+
		+	{\| class="wikitable" style="margin-left: auto; margin-right: auto; text-align: center;"
		+	\| style="width: 200px; \| [[OpenSSL Overview]] \|\| style="width: 200px;" \| [[Compilation and Installation]] \|\| style="width: 200px;" \| [[Internals]] \|\| style="width: 200px;" \| [[Mailing Lists]]
		+	\|-
		+	\| [[libcrypto API]] \|\| [[libssl API]] \|\| [[Examples]] \|\| [[Documentation Index\|Index of all API functions]]
		+	\|-
		+	\| [[License]] \|\| [[Command Line Utilities]] \|\| [[Related Links]] \|\| [[Binaries]]
		+	\|-
		+	\| [[SSL and TLS Protocols]] \|\| [[1.1 API Changes]] \|\| [[FIPS modules]] \|\| [[TLS1.3]]
		+	\|}
		+
		+	The main benefit in my opinion is the code. This is the code for the table:
		+
		+	<pre>
		+	{\| class="wikitable" style="margin-left: auto; margin-right: auto; text-align: center;"
		+	\| style="width: 200px; \| [[OpenSSL Overview]] \|\| style="width: 200px;" \| [[Compilation and Installation]] \|\| style="width: 200px;" \| [[Internals]] \|\| style="width: 200px;" \| [[Mailing Lists]]
		+	\|-
		+	\| [[libcrypto API]] \|\| [[libssl API]] \|\| [[Examples]] \|\| [[Documentation Index\|Index of all API functions]]
		+	\|-
		+	\| [[License]] \|\| [[Command Line Utilities]] \|\| [[Related Links]] \|\| [[Binaries]]
		+	\|-
		+	\| [[SSL and TLS Protocols]] \|\| [[1.1 API Changes]] \|\| [[FIPS modules]] \|\| [[TLS1.3]]
		+	\|}
		+	</pre>
		+
		+	The previous table's code used image files to manipulate the alignment, and I think it makes adding or removing links a lot harder than it needs to be.
		+
		+	<pre>
		+	<TABLE border=0>
		+	<TR>
		+	<TD>[[OpenSSL Overview]]</TD>
		+	<TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD>
		+	<TD>[[Compilation and Installation]]</TD>
		+	<TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD>
		+	<TD>[[Internals]]</TD>
		+	<TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD>
		+	<TD>[[Mailing Lists]] </TD>
		+	</TR>
		+	<TR>
		+	<TD>[[libcrypto API]]</TD>
		+	<TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD>
		+	<TD>[[libssl API]]</TD>
		+	<TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD>
		+	<TD>[[Examples]] </TD>
		+	<TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD>
		+	<TD>[[Documentation Index\|Index of all API functions]]</TD>
		+	</TR>
		+	<TR>
		+	<TD>[[License]] </TD>
		+	<TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD>
		+	<TD>[[Command Line Utilities]]</TD>
		+	<TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD>
		+	<TD>[[Related Links]]</TD>
		+	<TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD>
		+	<TD>[[Binaries]]</TD>
		+	</TR>
		+	<TR>
		+	<TD>[[SSL and TLS Protocols]]</TD>
		+	<TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD>
		+	<TD>[[1.1 API Changes]]</TD>
		+	<TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD>
		+	<TD>[[FIPS modules]]</TD>
		+	<TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD>
		+	<TD>[[TLS1.3]]</TD>
		+	</TR>
		+	</TABLE>
		+	</pre>
		+
		+	Let me know what you think; I appreciate any and all feedback.
		+
		+	-- [[User:Jflopezfernandez\|Jflopezfernandez]] ([[User talk:Jflopezfernandez\|talk]]) 19:52, 9 August 2019 (UTC)

@@ Line 1: / Line 1: @@
 Content Outline
 == Administrivia ==
 Site guidelines, legal and admininstrative issues.
 :* [[Basic rules]], [[Commercial Product Disclaimer]], [[Contributions]], [[Copyright]], [[License]]
+:* Using This Wiki
 == Reference ==
@@ Line 45: / Line 72: @@
 :* [[Elliptic Curve Diffie Hellman]]
 :* [[Elliptic Curve Cryptography]]
 == Internals and Development ==
@@ Line 52: / Line 78: @@
 :* [[Code Quality]]
 :* [[Static and Dynamic Analysis]]
 == Miscellanous ==

@@ Line 9: / Line 9: @@
 This section contains the automagically generated man pages from the OpenSSL git repository, and similar "man" style reference documentation. The man pages are automatically imported from the OpenSSL git repository and local wiki modifications are submitted as patches.
 :* OpenSSL Manual Pages
-:* [[Manual:Openssl(1)]], [[Manual:Ssl(3)]], [[Manual:Crypto(3)]], [[Documentation Index]]
+::* [[Manual:Openssl(1)]], [[Manual:Ssl(3)]], [[Manual:Crypto(3)]], [[Documentation Index]]
 :* [[API]], [[Libcrypto API]], [[Libssl API]]
 :* [[FIPS mode()]], [[FIPS_mode_set()]]
 == Usage and Programming ==

@@ Line 31: / Line 31: @@
 ::* [[EVP Message Digests]]
 ::* [[EVP Key Derivation]]
-::* [[EVP Signing and Verifying]]
+::* [[EVP Signing and Verifying|EVP Signing and Verifying (including MAC codes)]]
 :* Low Level APIs
 :: More specialized non-EVP usage
 ::* [[Diffie-Hellman parameters]]
 == Concepts and Theory ==

@@ Line 1: / Line 1: @@
-This [[Main Page]] really needs some work. Here are some initial thoughts on an overall organization:
+Content Outline
-* Administrivia
+== Administrivia ==
-: Site guidelines, legal and admininstrative issues.
+Site guidelines, legal and admininstrative issues.
-** [[Basic rules]], [[Commercial Product Disclaimer]], [[Contributions]], [[Copyright]], [[License]]
+:* [[Basic rules]], [[Commercial Product Disclaimer]], [[Contributions]], [[Copyright]], [[License]]
-* Reference
+== Reference ==
-: This section has the automagically generated man pages from the OpenSSL git repository, and similar "man" style reference documentation
+This section contains the automagically generated man pages from the OpenSSL git repository, and similar "man" style reference documentation. The man pages are automatically imported from the OpenSSL git repository and local wiki modifications are submitted as patches.
-** OpenSSL Manual Pages
+:* OpenSSL Manual Pages
-*** [[Manual:Openssl(1)]], [[Manual:Ssl(3)]], [[Manual:Crypto(3)]], [[Documentation Index]]
+:* [[Manual:Openssl(1)]], [[Manual:Ssl(3)]], [[Manual:Crypto(3)]], [[Documentation Index]]
-** [[API]], [[Libcrypto API]], [[Libssl API]]
+:* [[API]], [[Libcrypto API]], [[Libssl API]]
-** [[FIPS mode()]], [[FIPS_mode_set()]]
+:* [[FIPS mode()]], [[FIPS_mode_set()]]
-* Usage (or Programming?)
+== Usage and Programming ==
-: This section has discussions of practical issues in using OpenSSL
+This section has discussions of practical issues in using OpenSSL
-** Building from Source
+:* Building from Source
-** [[OpenSSL Overview]]
+:: Where to find it, the different versions, how to build and install it.
-** [[Versioning]]
+:* [[OpenSSL Overview]]
-** [[Compilation and Installation]]
+:* [[Versioning]]
-** EVP
+:* [[Compilation and Installation]]
 :: Programming techniques and example code
 :: Use of EVP is preferred for most applications and circumstances
-*** [[EVP Asymmetric Encryption and Decryption of an Envelope]]
+::* [[EVP Asymmetric Encryption and Decryption of an Envelope]]
-*** [[EVP Authenticated Encryption and Decryption]]
+::* [[EVP Authenticated Encryption and Decryption]]
-*** [[EVP Symmetric Encryption and Decryption]]
+::* [[EVP Symmetric Encryption and Decryption]]
-*** [[EVP Key and Parameter Generation]]
+::* [[EVP Key and Parameter Generation]]
-*** [[EVP Key Agreement]]
+::* [[EVP Key Agreement]]
-*** [[EVP Message Digests]]
+::* [[EVP Message Digests]]
-*** [[EVP Key Derivation]]
+::* [[EVP Key Derivation]]
-*** [[EVP Signing and Verifying]]
+::* [[EVP Signing and Verifying]]
-** Low Level APIs
+:* Low Level APIs
 :: More specialized non-EVP usage
-*** [[Diffie-Hellman parameters]]
+::* [[Diffie-Hellman parameters]]
-* Concepts and Theory
+== Concepts and Theory ==
-: Discussions of basic cryptographic theory and concepts
+Discussions of basic cryptographic theory and concepts
-: Discussions of common operational issues
+Discussions of common operational issues
-** [[Base64]]
+:* [[Base64]]
-** [[FIPS 140-2]]
+:* [[FIPS 140-2]]
-** [[Random Numbers]]
+:* [[Random Numbers]]
-** [[Diffie Hellman]]
+:* [[Diffie Hellman]]
-** [[Elliptic Curve Diffie Hellman]]
+:* [[Elliptic Curve Diffie Hellman]]
-** [[Elliptic Curve Cryptography]]
+:* [[Elliptic Curve Cryptography]]
-* Internals and Development
+== Internals and Development ==
-: This section is for internal details of primary interest to OpenSSL maintainers and power users
+This section is for internal details of primary interest to OpenSSL maintainers and power users
-** [[Internals]]
+:* [[Internals]]
-** [[Code Quality]]
+:* [[Code Quality]]
-** [[Static and Dynamic Analysis]]
+:* [[Static and Dynamic Analysis]]
-* Miscellanous
+== Miscellanous ==
+For the material that doesn't seem to fit anywhere else