Post Hoary

[Corey Burger]

2 thoughts on those -

1. The Documents
I see nothing very exciting about those documents. They are both 2
columns, which can easily be done a number of ways, including tables.
In addition. The Mac document is a marketing guide, NOT documentation.
The RHEL guide is documentation, but wastes a lot of paper, IMHO, with
that sidebar.

2. Target Audience

We really need to think who are we targetting with our documentation.
The vast majority of computer users use the web to get their
information. Google is their friend. If I was updating from RHEL 3 to
4, and if that pdf was not also on the web, I would be very annoyed. I
hate looking at vendor docs for this reason. (And yes I am a computer
tech by training and vocation).

Thus, I feel our primary focus should be getting good task-based short
howtos in a wiki-format on an easily searchable place. Print is dying
and docbook is designed for print, IMHO.

I guess what I am really trying to say is that who gives a damn if
MacOS/WinXP/your favourite Linux distro produces docbook and nice
looking (in print) monolithic stuff. If these methods worked then
there wouldn't be thousands of forums to get support from.

Corey