I find short examples the best form of documentation. Some thing that is 1-7 lines big and shows how to use the function. Some thing I could copy and massage it into what I want it to do. Rosettacode and stackoverflow are great for this reason.
I always try to include short examples into libs I write: * [https://github.com/treeform/typography](https://github.com/treeform/typography) * [https://github.com/treeform/cairo](https://github.com/treeform/cairo) I wish more of nim's doc would contain little snippets.
