Help page design, and the future of the Ubuntu Desktop Guide
Matthew Paul Thomas
mpt at myrealbox.com
Mon Jul 24 02:34:29 UTC 2006
As promised during the meeting on Saturday (Friday, for many of you),
I've written a wiki page on how I think we should write and arrange
help pages for maximum usefulness.
<https://wiki.ubuntu.com/UbuntuHelp/PageStructure>
As I described last month, the ideal structure, style, and content for
help pages -- and for a local help system as a whole -- is quite
different from the usual structure, style, and content for a printed
book.
<https://lists.ubuntu.com/archives/ubuntu-doc/2006-June/006585.html>
So if we're going to start adapting the Ubuntu Desktop Guide to this
structure, I can think of three options for the printed version.
(1) Fork it from the on-screen version, so that it can be given proper
book treatment (chapters, footnotes, screenshots, diagrams, etc).
(2) Continue it as a quirkier, recipe-book-style, printed copy of every
help page, without chapter introductions and the like.
(3) Retire it, leaving the job of publishing books to Apress, O'Reilly,
Canonical and Prentice Hall, Addison-Wesley, etc.
<http://urlx.org/amazon.com/d9ea0>
--
Matthew Paul Thomas
http://mpt.net.nz/
More information about the ubuntu-doc
mailing list