Just realized the reason I like this is the documentation isn't just an API reference, but a progressive refinement of the problem domain to solution domain map

Just realized the reason I like this is the documentation isn't just an API reference, but a progressive refinement of the problem domain to solution domain mapping. You start with a simple statement and gradually introduce concepts, problems and solutions.