Hi Fred and all other PB documentation maintainers,
I have a request that may seem a bit odd at first, but hear me out.
Currently, every reference page, whether it be for a function, compiler directives, etc., has every category, such as syntax, example, etc. as normal text, and then everything under them as block quotes. I'm sure this looks great visually, but to tell you the truth it's a bit of a nightmare for screen reader users. We much prefer to be able to navigate by heading/list/etc. Would it be possible to change the internal markup DocMaker produces to have the information encoded as proper headings, for example, if the function is AddGadgetColumn(), the text AddGadgetColumn() would be an h1, and syntax, description, etc would be h2's, with all the text under them being regular paragraphs/divs/code blocks? The block quotes add a ton of unnecessary noise and wouldn't be needed if headings were added. This doesn't strictly have to be the heading levels, it's just an idea, but the basic idea is a top-level heading, and then subsections have increasingly larger heading numbers.
The look wouldn't have to change either, as far as I know CSS is incredibly powerful and you can make it look however you like.
Thanks for your consideration!
Some accessibility suggestions for the documentation's HTML markup.
Moderator: Documentation Editors