Posted: Wed Feb 14, 2007 2:40 am
1. Not unless included in the package already though obviously a download is just a tarball away.# Should the auto-generated API documentation be made downloadable?
# Should there be tasteful graphics in tutorial-style documentation? A few pictures can really spruce up a document, at the cost of a few more seconds of download time (I love how A List Apart has an opening graphic for all its articles).
# How important is a PDF download to you?
# Is the pain of compiling docbook worth it? (I currently use HTML)
2. Nothing wrong with pictures especially if it breaks up the text only look and feel - some decorative typography is almost as effective.
3. I don't minds so long as the documentation, in whatever format, is printable.