Well, with hand-written documentation of course you can do more, but it’s lots of work. With doxygen you do nothing and you already get a full-featured comprehensive documentation, with HTML pages only one out of 12 (currently) options. For instance, it can also create a help file that is integrated for immediate lookup in eclipse or QT Creator. You don’t get what with a wiki. It can also produce a linear manual via LaTeX to create a PDF file from it, for those who prefer papers. And starting from this do-nothing approach, things can be customized and beautified to a certain extent, even including hand-written HTML code if needed. But it won’t necessarily be exactly the same as a hand-coded wiki page, unless you’d go even that far to modify the doxygen source or contact its developer to extent it (he’s ok, I had contact with him a couple of years ago and was quite open to include a suggestion).
What seems closest to your transclusion is doxygen’s \include{doc} special command:
https://www.doxygen.nl/manual/commands.html#cmdinclude
It allows to insert some documentation from one file in another place, and of course you can use that repeatedly and multiple places. That should be the same as the wiki’s transclusion; I wouldn’t do it though since it is additional work - like editing a wiki - and I personally prefer the documentation of types on another page anyway, like QT does it as well (as one of the documentation pages where I hang around lots).
For the git repo, sure, we can do that. I basically used the source from HDF5 1.12.0, edited two files there and created a doxygen configuration file. The layout with the side menu is the HTML output style option whether to generate a navigation panel or not (which is, like the two C++ websites, a matter of taste). There are more options, you’d need to explore which ones you like, and if users build their own documentation pages, they can use it up to their choice. The more effort is spent on the docu, the better it will become of course.
Would you want me to copy the entire hdf5 1.12 source in this demo repo or just those files that I modified?
