Documentation tags have a machine readable structure.
That structure can be parsed and used for documents, editor hints, diagrams, and even type check validations.
Instead of having to traverse the entire callgraph of a function to have an idea of what guarantees it provides, you simply read the documentation tag.
This is O(1) instead of O(V+E) where V are the functions and E are how you call them.