I definitely agree the documentation needs a bit of work - some more examples certainly wouldn't hurt, and improving the search ability (not just on-site but via Google too) would be a massive bonus. For instance, it took me a while (and I eventually asked on IRC) to work out that indexOf in Nim was called find and was in the struts module. Ideally, a search for Nim indexOf would have taken me somewhere explaining the actual proc with an example of its usage (and it's variations grouped in one place).
I did notice that Crystal uses [GitBook](https://www.gitbook.com) to generate [their docs](https://crystal-lang.org/docs/), which are very well laid out, easy to read, searchable and seem to be surfaced on Google much more readily. Possibly there's a way to optionally hook into that somehow?
