**Where to from here?** So, the documentation can be improved, but saying that accomplishes nothing beyond the current status quo.
There should be an official Nim **cookbook** (hosted on nim-lang.org ?) which contains code examples that can be referenced from the other documentation types (help keep the other doco focused), and is easily contributed to via the usual git PRs.