re: godocs

Note that GoLang lacks generics and default function arguments, so of course 
its functions are easier to document. In Go, libraries are easy to use but hard 
to write. That makes Go an enticing language, but also a very limiting language 
after you use it enough.

I think the way to document a Nim library is [by 
example](https://github.com/def-/nim-unsorted), often via [Rosetta 
Code](https://www.rosettacode.org/wiki/Binary_strings#Nim) . I wish we had many 
more examples in the docs. (And btw, Go's ["Testable Examples" as 
documentation](https://blog.golang.org/examples) are yet another great feature 
of the Go ecosystem.)

Reply via email to