Re:The sorry state of OpenSSL usability
by moomin on Thursday December 28, 2017 @04:19PM
(#16024968)
He could, but you seem to be expecting him to do this work for free. The article he’s written is useful, informative and free, so you seem to have a catch-22 when you criticise him for not going further.
Re:The sorry state of OpenSSL usability
by smhenderson on Thursday December 28, 2017 @04:18PM
(#16024962)
But there is documentation for LibreSSL. As an OpenBSD project they take documentation just as seriously as code. I just don't get how the article makes that claim when there are links to any man page you need here: http://www.libressl.org/
Re:The sorry state of OpenSSL usability
by SAI_Peregrinus on Thursday December 28, 2017 @04:31PM
(#16025050)
There are links to the documentation, but they're not labeled as such. They're labeled as though they're links to download the components.
Re:The sorry state of OpenSSL usability
by proginthebox on Thursday December 28, 2017 @09:36PM
(#16027081)
It does not have a "documentation" link. It does not even say "man pages" anywhere on the page. ALso, the man pages go to something called "openssl", and when I click on the link, there is no "libressl" on the resulting page. Am I still on the libreSSL site? Is the libreSSL API exactly same as OpenSSL API? I have no clue. If it is, it does not say so, if it is not, it does not say so. What a mess.
You could write some documentation and give it to them. Or you could pay someone to write it for the project.
The author seems to know quite a bit about OpenSSL/LibreSSL. I'd think writing up a bit of documentation for it would be a win for everyone. Writing a blog complaining that the authors haven't done it and given it away for free is not.