Docs QA
Travis Whitlock
btw9979 at gmail.com
Thu Nov 11 20:19:03 UTC 2010
I'm not committed to anything right now and I am looking for something to
do. Let me know if anyone wants to put their work under my scrutiny :)
On Thu, Nov 11, 2010 at 8:16 PM, Paul W. Frields <stickster at gmail.com>wrote:
> 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 at lists.fedoraproject.org
> To unsubscribe:
> https://admin.fedoraproject.org/mailman/listinfo/docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.fedoraproject.org/pipermail/docs/attachments/20101111/0e562322/attachment.html
More information about the docs
mailing list