+1 Also, reference docs are not the same thing as tutorial/learning docs. The two should complement each other, but the latter should really focus on gently br

+1 Also, reference docs are not the same thing as tutorial/learning docs. The two should complement each other, but the latter should really focus on gently bringing in people new to a product, technology, ecosystem, whatever. Shouldn't need to be said, but from experience, it does.