> 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.
Unless of course it is wrong, because it is just a convention for a comment and not actually an enforced type.