1. Would you find having documentation available in HTML format (as wells as PDF) useful to you?
Absolutely. When getting up to speed having the printed docs to read through linearly is very helpful, but for actual development having something hyperlinked is much better. Getting the hyperlinking right isn't a trivial undertaking, but it make a huge difference in the ease of using the docs. Data types should link back to their definitions and such.
2. Would you find having documentation the HTML format used for the PHP and MySQL online manuals, where you can add comments? Personally, I've found that over time, the value of the comments on just about any page of the online PHP docs is far greater than the original page content.
Sometimes it can be very helpful and sometimes it can be very misleading. Having the HTML docs available with and without commentability would be really spiff. If the documentation authors actually pay attention to the comments and update the documentation accordingly then the necessity of seeing the comments shouldn't be all that great.
-- </chris>
"There are four boxes to be used in defense of liberty: soap, ballot, jury, and ammo. Please use in that order." -Ed Howdershelt (Author) _______________________________________________ domains-dev mailing list [email protected] http://discuss.tucows.com/mailman/listinfo/domains-dev
