Improve documentation of the `diagrams` tool