Improving AI use of documentation with HTML semantic tags

[Greg Couch]

The documentation could be enhanced to make it easier for AI agents and other software to understand the meaning of the parts of the documentation with semantic tags. In general, that means not using <div>, <pre>, <b>, et.al. when more expressive tags are available. In the case where there isn't an appropriate preexisting HTML semantic tag, we could associate a css class that has meaning.

For example, the <nav> semantic tag listed in ​https://www.w3schools.com/html/html5_semantic_elements.asp would let the AI agent skip over that part of the page and help screen readers.

Also look at ​https://www.w3schools.com/html/html_computercode_elements.asp. Clearly identifying what is typed on the command line with <kbd> and the log output with <samp> instead of <pre> would be very helpful. For example, instead of "<b>wobble</b>", it could be "<kbd style='command'>wobble</kbd>". And there would be css for 'command' that would do the bolding.