Userguide patch

matthew.east.ubuntu at breathe.com matthew.east.ubuntu at breathe.com
Fri Jun 24 00:27:21 UTC 2005


N'Jal Munro writes: 

Hi Neil, 

Thanks for the work. However there are a couple of things that I think you 
should work on before we apply the patch. You asked for feedback on irc, so 
here goes! 

First of all, please don't change the title of the book! 

Secondly, try to avoid a chatty style, and keep things linguistically 
simple. This is good because it makes it easier for readers of many cultures 
to understand, and also makes it easier to translate: its good to avoid 
colloquial language and humor because these things don't translate well. 

You might want to take a look at our style-guide, currently being worked on 
in our archive, or take a look at the completed gnome styleguide at 
http://developer.gnome.org/documents/style-guide/ 

One technical thing: the semi colon in the following section is unnecessary: 
<ulink url="http://www.ubuntuforums.org;">Ubuntu Forums</ulink> 

However, if you want to use one of the entities in our /libs/glocal.ent, for 
example the link to Ubuntu forums, you can do this like so:
<ulink url="&ubuntu-forums;">Ubuntu Forums</ulink> 

Hope this helps!! Thanks for your efforts and we hope to get more patches 
from you in the future! 

Matt




More information about the ubuntu-doc mailing list