[TOS] writing style for textbook

Greg DeKoenigsberg gdk at redhat.com
Tue Mar 16 13:05:52 UTC 2010


On Tue, 16 Mar 2010, Karsten Wade wrote:

> 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."
>
> Reading the chapters and thinking about voice consistent, I think that
> means we can feel OK with using the second-person pronoun "you", be
> sparing but don't sound stilted.  Third person references are for
> other existing entities, such as upstream projects.  For consistency,
> we can remove any first-person references.

I agree with this.  It sounds right in the little voice in my head.

--g

--
Educational materials should be high-quality, collaborative, and free.
Visit http://opensource.com/education and join the conversation.



More information about the tos mailing list