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 doc

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.