The prominently advertised HTML documentation gives a poor user experience (many clicks to read through the document, footnotes containing relevant information at awkward places, poor usage of screen area, volatile deep links into the document, no folding/unfolding of TOC, mediocre notion where you are in the doc because of lack of page numbers and visual impression of pages, etc)
We cannot expect anyone to clickread through the whole document.
And there is the PDF documentation (nice rendering and fonts, folding/unfolding of TOC, functional internal and external links, nicely archivable, it's an expected format for complex information. And one can (or could) print it!)
While HTML doc should exist it should not be advertised. (should only be reachable with at least an additional mouse click).
Log in to post a comment.