* real documentation - as opposed to just proc comments * Examples, examples, examples * Explanations for more difficult matters like async, threading, etc. Something like page or two only "generally" explaining how those work in Nim (from there the user can go to the modules normal docu and learn practical details.
The basic structure is this: First give the user an "overview" how e.g. Nim threading works. Then give him examples to show how it's done in Nim. Finally, have good docu for the language (which I find not great but acceptable) and the libraries (which I often find poorly docu'd).
