I've been testing how nice it would be to use man.sr.ht for
documentation for my OS project. I have an article in place of
a source file and I'm almost fully satisfied.
Article in question: https://man.sr.ht/~samhsmith/AstraOS-wiki/src_tree/src/elf.c.md
As you can see in the article there are two subheadings called
"Members". Each one refering to the struct members of the struct
described in the heading above. If you click the Members section
in the table of contents you will go to the first. This is because
the link generated takes only into consideration the name of the
heading. While it is probably unwise to have the links be numbered,
ex Members and Members2. Having the links generated include parent
heading would allow me to link to the two Member sections
independently.
I won't personally be doing that often but it does strike me as
unintended behaviour. For feature completeness and a user
experience that feels less "buggy" the links to different
subheadings of the same name ought to be differentiated.
Otherwise, I'm loving man.sr.ht, thank you.
--
Sam H Smith