Comment by citrin_ru

It's a false dichotomy good documentation should have both - comprehensive reference and examples.