[TOS] writing style for textbook
kwade at redhat.com
Wed Mar 17 05:16:07 UTC 2010
On Tue, Mar 16, 2010 at 07:15:37AM -0500, Matthew Jadud wrote:
> 2010/3/16 Karsten Wade <kwade at redhat.com>:
> > On Sun, Mar 14, 2010 at 11:14:53AM -0700, Karsten Wade wrote:
> >> What is our writing style for the textbook going to be?
> > In response, Greg Dek said:
> > "Somewhere between semi-informal textbook tone and informal how-to
> > tone."
> The last collaborative book I was part of included two important passes:
> 1. A "transitions" pass, and
> 2. A "voice" pass.
> That is, we had one member of our team go through the entire text
> adding transitions. They might be at the end of chapters, the front of
> chapters, or even within chapters. Then, another member of the team
> went through the entire document, editing for voice. Although we all
> tried to write with a unified voice, the fact was that it wasn't
> possible with 8, 9 people co-authoring. The unification pass smoothed
> out differences in style, and left us with a very readable text.
That's a good grouping of items to go alongside some other edit passes
I wrote down. I've been adding columns to the chapter to-do tracker,
and I just rejiggered it to come up with this:
Here are the column headings:
! % Complete (1st draft)
! Tech + syntax
! Lang + grammar
! gregdek bit
name: Karsten 'quaid' Wade, Sr. Community Gardener
team: Red Hat Community Architecture
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Size: 189 bytes
Desc: not available
More information about the tos