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