That's a great idea Mark and Will, I would be happy to contribute anything that I learn about the toolkit.
There have been a wide range of comments from people saying "look at the code" all the way to basically suggesting an attempt at a new version of the O'Reilly book. I can't imagine anyone with any experience at all in software development suggesting that the only source of documentation be the source code. And I don't think I was suggesting that the OpenSSL team necessarily write a new version of the O'Reilly book. Someone also said that if we wanted documentation we should pay for it - which seems counter to the whole open source effort. I'm assuming that the OpenSSL developers are not spending all this time working on the toolkit for the hell of it - I would think they would like as many people to use it as possible, and with that goal in mind, I think the 1.0 release (when it comes out of beta) would be a good stopping point to re-visit the documentation set and providing examples that reflect the most common use-cases. The mailing list is always here for unusual use-cases. That being said, I think a Wiki is also a great idea, but would not obviate the need for the developers of the toolkit to complete the documentation set. I've spent a quite a bit of time with OpenSSL and would be happy to contribute to a Wiki. Thanks!! Randy On Nov 25, 2009, at 3:13 PM, Will Bickford wrote: > IMO a wiki would be a great resource for both developers and users of > OpenSSL. > > Something along the lines of the Subversion Book - an online reference > "book" for OpenSSL. > > --Will > >> -----Original Message----- >> From: owner-openssl-us...@openssl.org >> [mailto:owner-openssl-us...@openssl.org] On Behalf Of Mark >> Sent: Wednesday, November 25, 2009 3:27 AM >> To: openssl-users@openssl.org >> Subject: RE: General question about documentation >> >>> I would like to post a general observation regarding users of the >>> OpenSSL toolkit. >> >> [snip stuff about documentation]] >> >> A long time ago it was suggested to use a wiki for this >> purpose. Can this idea be resurrected? >> >> Mark. >> >> ______________________________________________________________________ >> OpenSSL Project http://www.openssl.org >> User Support Mailing List openssl-users@openssl.org >> Automated List Manager majord...@openssl.org >> >> > ______________________________________________________________________ > OpenSSL Project http://www.openssl.org > User Support Mailing List openssl-users@openssl.org > Automated List Manager majord...@openssl.org > ______________________________________________________________________ OpenSSL Project http://www.openssl.org User Support Mailing List openssl-users@openssl.org Automated List Manager majord...@openssl.org
