On Sat, 2005-09-10 at 08:35 -0400, Ignacio Vazquez-Abrams wrote:
I've just completed a few more sections in my guide and I'd
like someone
to look it over for language, consistency, and flow, as well as actually
trying out the instructions to see if they make sense. The relevant
sections are the introduction for "Creating a New Package" as well as
the entire contents of the "Case Study: leafpad" section.
http://www.fedoraproject.org/wiki/Docs/Drafts/BuildingPackagesGuide
I gave it a read over, it is looking good. Valuable document for the
target audience.
I edited about 50%, mainly for passive -> active voice, consistent use
of second-person (you instead of we/us), and removing a few usages of
idioms and overly casual language. If you read through the diff, you
should be able to get the idea, and can finish the rest of the document
in a similar fashion. It's a small number of style items, but it helps
make the document smoother.
Thanks, keep it coming.
- Karsten
--
Karsten Wade, RHCE * Sr. Tech Writer *
http://people.redhat.com/kwade/
gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41
Red Hat SELinux Guide
http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/selinux-guide/