Difference between revisions of "Talk:Main Page"

From OpenSSLWiki
Jump to navigationJump to search
(Update with section headers)
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
Content Outline
 
Content Outline
 +
 +
== OpenSSL Quick Links ==
 +
 +
  <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>
 +
      </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>
 +
      </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>
 +
      </TR>
 +
  </TABLE>
  
 
== 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]]
 
+
:* Using This Wiki
 +
:: [http://meta.wikimedia.org/wiki/Help:Contents Wiki User's Guide], [http://www.mediawiki.org/wiki/Manual:Configuration_settings Configuration settings list], [http://www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ], [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki Mailing List]
  
 
== Reference ==
 
== Reference ==
 
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.
 
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]]
 +
:: If you wish to edit any of the Manual page content please refer to the [[Guidelines for Manual Page Authors]] page.
 
:* [[API]], [[Libcrypto API]], [[Libssl API]]
 
:* [[API]], [[Libcrypto API]], [[Libssl API]]
 
:* [[FIPS mode()]], [[FIPS_mode_set()]]
 
:* [[FIPS mode()]], [[FIPS_mode_set()]]
 
  
 
== Usage and Programming ==
 
== Usage and Programming ==
Line 31: Line 58:
 
::* [[EVP Message Digests]]
 
::* [[EVP Message Digests]]
 
::* [[EVP Key Derivation]]
 
::* [[EVP Key Derivation]]
::* [[EVP Signing and Verifying]]
+
::* [[EVP Signing and Verifying|EVP Signing and Verifying (including MAC codes)]]
 
:* Low Level APIs
 
:* Low Level APIs
 
:: More specialized non-EVP usage
 
:: More specialized non-EVP usage
 
::* [[Diffie-Hellman parameters]]
 
::* [[Diffie-Hellman parameters]]
 
  
 
== Concepts and Theory ==
 
== Concepts and Theory ==
Line 46: Line 72:
 
:* [[Elliptic Curve Diffie Hellman]]
 
:* [[Elliptic Curve Diffie Hellman]]
 
:* [[Elliptic Curve Cryptography]]
 
:* [[Elliptic Curve Cryptography]]
 
  
 
== Internals and Development ==
 
== Internals and Development ==
Line 53: Line 78:
 
:* [[Code Quality]]
 
:* [[Code Quality]]
 
:* [[Static and Dynamic Analysis]]
 
:* [[Static and Dynamic Analysis]]
 
  
 
== Miscellanous ==
 
== Miscellanous ==
Line 64: 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)
 +
 +
: Wow - yeah. That looks great to me.
 +
: --[[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)
 +
 +
::: 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)

Latest revision as of 08:00, 27 August 2019

Content Outline

OpenSSL Quick Links[edit]

OpenSSL Overview HTAB.pngHTAB.png Compilation and Installation HTAB.pngHTAB.png Internals
libcrypto API HTAB.pngHTAB.png libssl API HTAB.pngHTAB.png Examples
License HTAB.pngHTAB.png Command Line Utilities HTAB.pngHTAB.png Related Links

Administrivia[edit]

Site guidelines, legal and admininstrative issues.

Wiki User's Guide, Configuration settings list, MediaWiki FAQ, MediaWiki Mailing List

Reference[edit]

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
If you wish to edit any of the Manual page content please refer to the Guidelines for Manual Page Authors page.

Usage and Programming[edit]

This section has discussions of practical issues in using OpenSSL

  • Building from Source
Where to find it, the different versions, how to build and install it.
Programming techniques and example code
Use of EVP is preferred for most applications and circumstances
  • Low Level APIs
More specialized non-EVP usage

Concepts and Theory[edit]

Discussions of basic cryptographic theory and concepts Discussions of common operational issues

Internals and Development[edit]

This section is for internal details of primary interest to OpenSSL maintainers and power users

Miscellanous[edit]

For the material that doesn't seem to fit anywhere else

  • New topics pending categorization (not yet linked elsewhere)
  • Incomplete or contentious pages under discussion



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 --Matt 15:02, 30 May 2013 (UTC)

Proposed Change: Quick Links[edit]

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.

OpenSSL Overview Compilation and Installation Internals Mailing Lists
libcrypto API libssl API Examples 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:

{| 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 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.

  <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>

Let me know what you think; I appreciate any and all feedback.

-- Jflopezfernandez (talk) 19:52, 9 August 2019 (UTC)

Wow - yeah. That looks great to me.
--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.
-- 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.
--Matt (talk) 08:00, 27 August 2019 (UTC)