Talk:Main Page

From OpenSSLWiki
Revision as of 08:00, 27 August 2019 by Matt (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

Content Outline

OpenSSL Quick Links

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

Site guidelines, legal and admininstrative issues.

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

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.

  • 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

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

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

Internals and Development

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

Miscellanous

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

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)