With reference docs, I really value the examples. Describing the syntax, in a formal way is necessary sure. But I often skip down to the examples and that way

With reference docs, I really value the examples. Describing the syntax, in a formal way is necessary sure. But I often skip down to the examples and that way I get a feel for it quickly. Bonus points if the examples are thoughtful in the way they start with simple cases and move up to more complex ones while remaining practical and thus easy to imagine their usefulness.