On Wed, Nov 10, 2010 at 04:09:28PM -0600, 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. > > 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. This is a great idea. Most dead-tree technical books out there (including the ones about Fedora) get independent technical review. Having done this myself, I can tell you it definitely helps the finished product immensely. We probably have other lurking people who would put a hand up and say, "I can test <N> chapters of this book for you." -- Paul W. Frields http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 http://redhat.com/ - - - - http://pfrields.fedorapeople.org/ Where open source multiplies: http://opensource.com -- docs mailing list docs@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe: https://admin.fedoraproject.org/mailman/listinfo/docs
