I'd expect documentation-only-for-very-smart-people to be complete, correct, and rigorous, but lacking in examples, rationale, and perhaps organisation.
That's not at all what I see in the documentation for Google's public libraries and frameworks.
That's not at all what I see in the documentation for Google's public libraries and frameworks.
For all that I love Datomic, their docs are a particularly egregious example of this, IMO. See: http://docs.datomic.com/query.html