What size chunks do you prefer for HTML documentation?
- An entire <book> as a single HTML file?
- Split the book into one HTML file per <chapter>?
- Even smaller chunks than chapters?
So far we have been generating one HTML file per <book>, because the docs are still mostly outline, little content. Even the OpenDJ Admin Guide is still only 112 pages in PDF. With a single book file, you can /search or Ctrl+F search to find what you want.
Trouble is, as the docs grow, pages can become quite large. What still works in a document with the equivalent of approx. 100 pages of text might not work so well in a document with the equivalent of 500 pages, plus a number of graphics.
Another alternative would be to generate both. Still discussing with the docbkx-tools community about that.