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