Greetings,

I have just subscribed and hopefully I am not breaking any list etiquette
here, but I wanted to respond to the thread that was started back in April
on Improving the Documentation for OpenSSL.

http://marc.info/?l=openssl-dev&m=139832883828644

I am a developer (BS CS, Minor in Math) but not up to speed with the
OpenSSL library and more to my immediate interests, the cryptographic
library that is part of OpenSSL.

I am looking at using it in an upcoming project, but I definitely need to
learn more about crypto.

However, getting started with OpenSSL from reading the main project page at
openssl.org and the wiki leaves a bit to be desired. The wiki was very
useful however as it was the only place I could find usage examples ;)

It took me a while to get started with a simple example and just getting an
overview of the API is not easy (yes the source code which I am using).

I also noticed that some of the code examples need to be updated.

So I think that there are really three different areas of documentation
that would be useful:

- User documentation for the command line applications
- Developer documentation for the OpenSSL / Crypto APIs
- Up to date code examples for the usage of the APIs

Having a single online resource for this would be great (unless I am
completely missing a resource here).

My main incentive is to provide a resource that developers could use to get
started with the API quickly while also providing inline best practices and
good coding examples.

I have sent an email requesting access to the wiki and am interested in
helping out where I can.

Sorry for the long message!

Regards,
Casey

Reply via email to