We are planning to switch how we write our documentation from our current tex-pdf-html approach to something less tricky and more suitable to our purposes.
We're collecting requirements at the moment, and are very interested to know how the community uses the documentation. Two of our big questions are whether we still require PDF documentation at all (i.e. just online instead), and whether context-sensitive help is used at all.
If you have any other comments or suggestions, add them to this thread. Thanks for participating in the poll!