Docs QA

Thu Nov 11 17:19:45 UTC 2010

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

On 11/10/2010 05:09 PM, Jesús Franco wrote:
> On Wed, Nov 10, 2010 at 09:40:41PM +0100, Travis Whitlock wrote:
>> I would suggest attempting to have an independent reviewer.  Meaning a
>> member of the docs team that ideally has not worked on the section they are
>> reviewing.  Familiarity with a document is usually the best way to overlook
>> mistakes.
> 
> It would be a great way to letting 'shy' people like me, not brave
> enough to mess with the work done, but able to read and test some
> things and reporting some issues, actually contributing to the
> project.

Yeah.  I'm hoping this will allow more people to become involved in the
process and that the process will become yield better documentation out
the door.

> 
> I'm glad with this *huge* proposal. I'm going to take it to
> translators too, because sometimes the translators don't use
> terminology dictionaries (nor peer reviews), and leads to confussion
> when instead of using the terms specific for the matter of the
> documentation, they use generic translations, missing the sense of the
> original author.
> 
> QA for translations too!

Yeah, QA for translations are also important.  Being mono-lingual I can
only look to see if I can read any portion of a translated guide.  If I
can I know there are problems with the translation.  If I can't I know
someone has translated it and hopefully they've correctly done so.

- --Eric
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Fedora - http://enigmail.mozdev.org/

iQIcBAEBAgAGBQJM3CWxAAoJEDbiLlqcYamx1AcP/j7uXPoglenYUW0cd9sWGIR+
zzi52+jhXCZdSto2jEQyP8DSMa66xy6oDDF7X1KnA4vOLazSmWUdHKsSmYRkBWzD
XkJ6VCEHZAMGU+8W6gHljy/hBTIV/pt+i5OGuXIr75IdwFpuJRTnNxkvfiL1zqvu
rZKH/ztcXO7C+0iPhwaOeEyH8vMMl5Yk8XD49/SchbcJPOvXXi2nuT79RCo0coTh
dhDJJoJoQTfhMTGd6M1Giup2wBfAzxiDxAPLAag/fAWbQ1XKWfYmt0QgFFkscQlS
UUQ7tCIs6ORR9AQ4spDdMfbxq+N+28UzZRNgTLSw4EsCWr5nXaV7q71S/yHwQIeM
5NkFeTQhvxpZpiH1TmUYc2gmABJqkFBrtKBF0eE8gZLNKzfHae5q25elBACXONhl
LIMNp35np7ADOg+6SOxv0QjWzNNBirOCN5C6yCYyJmebevYMebETq6iC2snhrXKA
Pw7HlD4HDsKNH3/mitwamXlfFlasXMJI3qL+B7iMaPk9ZeTh8pe2IhYsnZ5IdjHF
75jeRdVE/8O6ZLORxqiQ62yqkQeVHZyUtF9y0BINVots+0jzxm4x87DuP2Bci3TR
A9PWcHfTT4JqWeINQwp5KGeKkb7a432VAsBJga7pQ2bEkQcsIr28ZyTbWgCd0KBL
GtdKd5UXdeX3Dyhx5+lu
=Lo/Z
-----END PGP SIGNATURE-----