Patch for Ubuntu Desktop Guide (Re: Words to avoid?)

[Matthew East]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hello!

* Matthew Paul Thomas:
> On Jul 8, 2006, at 6:47 AM, Matthew Paul Thomas wrote:
>> ...
>> And so that I'm not just bikeshedding as usual, here's a diff to
>> improve the Ubuntu Desktop Guide.
>> ...
> 
> And since the mailing list dropped it for being too large, Jordan Mantha
> kindly put a copy on doc.ubuntu.com.
> <http://doc.ubuntu.com/~laserjock/diff-udg-1>

Thanks a lot for this patch. I've been through it, and it has loads of
good stuff. I'd like to apply it, aside from a couple of things, but it
results in some seriously invalid docbook... Use the validate.sh script
in our repo to check desktopguide.xml, and see if you can fix some of that.

Here are the things I didn't like in the patch, and if possible I'd like
you to revert:

As discussed on irc, as it is now the desktop guide is a book, and so
the following changes I think are inappropriate:
 * Removing the introductory paragraph from each chapter explaining what
the chapter does.
 * Removing much of the preface.

I generally approved of the sections where you removed things from
procedures because they weren't procedures, but in two cases I think
that you removed things that _were_ part of procedures:
 * Menu editing - opening alacarte is part of that procedure
 * Setting up 3d rendering on an ATI card - all those steps are part of
the procedure

Otherwise, really nice work - I'd like to see lots of the linguistic
changes you made in the styleguide. I'll reply separately to your mail
about some of the conventions you've changed.

Matt
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2.2 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFEsNTstSaF0w5rBv8RAsnWAJ9xbfByFp0KVnoM90LjrY2UpuZXggCfU8RD
NIF+4nuzeAfTE/QUv5DtfWA=
=ZX/Z
-----END PGP SIGNATURE-----