A Python library from the version I started with. 
<https://docs.python.org/release/1.5.2/lib/module-tempfile.html>

A similar library from current Nim. 
<https://nim-lang.org/docs/tempfiles.html#createTempDir%2Cstring%2Cstring%2Cstring>

The same, but current, Python library, 20+ years later. 
<https://docs.python.org/3.11/library/tempfile.html>

In the early days of python bookshops 'only' carried Perl books. The comments 
on the Python documentation where very much like they are now for Nim.

What many forget that the main documentation is not a novel or a hand holding 
tutorial, but a manual and a reference. To be honest, for me that is not 
enough. I'm not a programmer.

Around the turn of the century I maintained the POV-Ray documentation for a 
small decade. Wrote large chunks for it. It is split in three sections, one OS 
dependent stuff, a big general tutorial and a reference. The latter is what I'm 
still not happy with. <https://wiki.povray.org/content/Reference:Keywords>

Maybe it would work if there where separate per library tutorials, layered as 
also @cblake suggests? As each library is different for one a recipe collection 
may work (times? how to add local month names), another may need more elaborate 
prose (async? I'm thinking of something like Pythons logging cookbook 
<https://docs.python.org/3.11/howto/logging-cookbook.html#logging-cookbook>)

Reply via email to