4 ms·
> Another thing I found bothersome were the generated GoDoc pages. They were ordinarily not as easy to understand as hand written Node.js GitHub readme pages an
by andrewstuart2 10y ago
> Another thing I found bothersome were the generated GoDoc pages. They were ordinarily not as easy to understand as hand written Node.js GitHub readme pages and came with very few, if any, examples.
I'll definitely agree here. It's not obvious right away how to write examples that get included in the generated documentation, and definitely unintuitive that it's a completely different process than the comment-based approach.