On 04/23/2014 04:52 PM, Matt Caswell wrote: > I am actively seeking people to help out on the OpenSSL Wiki. > Documentation is an area where OpenSSL has frequently been criticized > in the past and is an area where we can do something about it NOW.
fwiw, i actually don't think that a wiki is going to improve the places
where OpenSSL documentation is legitimately criticized.
historically, OpenSSL documentation (e.g. manual pages, etc) has
seriously lagged its implementation, and has in some cases been simply
wrong. Updates to the wiki won't improve the quality of documentation
shipped with the library, which will always seem more authoritative
(because it ships with the specific version of the software that is
installed; advice found on the web may be either older or newer than the
local version)
A serious way to fix this is to have the documentation produced *from*
the code, so that it gets upgraded in sync. For example, neither
x509(1ssl) nor "openssl x509 -help" ever mention the -sha256 option,
but that option has been supported for years.
--dkg
signature.asc
Description: OpenPGP digital signature
