Ubuntu Style Guide

Rich Johnson nixternal at ubuntu.com
Sat May 26 18:47:41 UTC 2007


Hey everyone!

I was just looking through the style guide and noticed we need to add some 
things, change some things, and clean up some inconsistencies that I have 
noted.

I would like some input from the various members involved with writing 
documentation in the GNOME, KDE, and Xfce camps as to how we can clearly 
define a set standard for our (Ubuntu) documentation. It will be a bit of 
work, but I think it can easily be accomplished within a short period of 
time.

Some simple questions/bullets I have are: (should we...)
1) Drop the Book/Chapter talk for tags? (seeing as we use <article> now for 
the topic based help.
2) Explain the topic based help configuration?
3) Create a sections for GNOME, KDE, and Xfce? To think about it, style 
should/could be the same.
4) Convert this documentation into a wiki page instead or is it better being 
left as is?

I am sure I will come up with more, but I just wanted a little input from 
everyone who is currently writing or will be writing official documentation. 
Thanks everyone!

-- 
Rich Johnson
nixternal at ubuntu.com
GPG Key: 0x2E2C0124
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part.
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20070526/10a664aa/attachment.pgp>


More information about the ubuntu-doc mailing list