[mikewarot]

Autogenerated documentation really sucks as well, no matter if it is tree, graph, or wiki based. (Which are all the same thing, in the end)

The bane of my existence in the last 24 hours is a typical example: https://www.freepascal.org/docs-html/current/rtl/fgl/tfpgmap...

There are links that go places, but nothing anywhere actually shows working code examples, or even non-working fragments.

One of the reasons actual civilians were able to write their own programs back in the 1980s was that Turbo Pascal, and Visual Basic had decent manuals, and there were plenty of "dummies" guides as supplements.

Documentation should include working example code for each and every library, function and property supplied.

/End old man rant