An OpenSSL cookbook, where and how?

[Richard Levitte]

As part of a documentation effort, more specifically in some
discussions in https://github.com/openssl/openssl/pull/11220 (exact
references below), I've floated the idea that bigger coding examples
should be placed into a cookbook.

My reasoning for this is very simple: example code in reference
manuals should be kept minimal and focused on the functions documented
in that same page.  Anything that start involving too much other
functions becomes a distraction, or will leave you wondering why the
example is in *this* page and not *the other page* that describes
those other functions.  In my mind, this is education 101.

However, it's true that people may want to see more complete examples,
where the interaction between different sets of functions is on
display, and could serve as code to pick and use, more than the quick
minimalistic examples.  A cookbook.

So if we should do this, where do we want that cookbook?  Who keeps it
up to date, and how?  https://wiki.openssl.org/ could be one answer,
but is it the answer we want?

Thoughts welcome!

Cheers,
Richard

-- 
Richard Levitte         levitte at openssl.org
OpenSSL Project         http://www.openssl.org/~levitte/