Comment by arendtio

I like documentation that starts with a minimal but functional example, followed by the most common additions to improve the solution and finally a complete documentation of all functions.

Having links to actual code, like GoDocs have it, is something I appreciate too.