Joshua Slive wrote: > > As I think is evident, I am interested in improving the consistency (and > usability) of the module docs by putting them all in a standard format. I > have made a suggestion of a format (See message-id > <[EMAIL PROTECTED]>) > but I really don't feel comfortable going ahead without some feedback. > I am sure that there are improvements that could be made, since I am > neither an HTML design expert, nor a documentation expert. > > So, how about some of you lurkers out there on the list take a look and > make some suggestions. (Feedback from Apache group members is obviously > acceptable as well.) > > The format I suggested is just about as close as possible to the format > that many of the module docs are already in. Is more detail needed? Less > detail? Should we be looking at a non-html format (DocBook, XML, > whatever...). Should it be "flashier" like mod_rewrite.html?
I liked it. It was very much in line with what I wished was there when I was reading through all the docs - that is, making every doc look the same, so you can count on certain information. Individually, most of the docs are just fine, but taken as a whole, the inconsistency really gets to me. Rich
