Improving Examples and Documentation

[didlybom]

Another reason to try to have better docs, _with 
[examples](https://forum.nim-lang.org/postActivity.xml#examples) (as well as 
commenting code well) is that it should help with LLMs learning more nim. In my 
experience they work pretty well with mainstream languages like python, but 
they hallucinate quite a bit when writing nim code.