I'm coming a little late to this thread so apologies! Most of the previous thread has focused on analysing the various pros and cons of the various documentation methods, INFOText/html/org, to produce the final documentation.
I would like to suggest that whatever method is used that it also supports the development workflow cycle of emacs. Core features that are documented should also have corresponding testplans. John Wiegley makes this point in his in his YouTube talk with Sacha Chua https://www.youtube.com/watch?v=nUjgKoOYxos. He concisely summed up the workflow issue as 'bugs/tests/documentation'. It was one of the areas that needed more effort. The challenge is to elegantly manage the documentation process so that it caters for the complete workflow development cycle. I favour the use of org as it has the capability of embedding tests within the documentation, among other things. Ciaran
