From kwade at redhat.com Fri Sep 1 16:35:21 2006
From: kwade at redhat.com (Karsten Wade)
Date: Fri, 01 Sep 2006 09:35:21 -0700
Subject: empowering the user and traditional tech writing - style discussion
Message-ID: <1157128521.29248.37.camel@erato.phig.org>
We need to discuss our writing style approach; I think it's too late for
FC6, so we need to stick with what works for now. But Paul W. Frields
challenged me with the idea of empowering the user and having a specific
style to support that.
In traditional tech writing, we try not to use pronouns yet keep an
active voice. It makes for a cleaner writing, easier to translate, and
has fewer assumptions implied about the reader, which helps to make it
more accessible. It also sounds less like marketspeak[1] and
cheerleader-writing[2].
For example:
"You can click on Applications > Sound & Video > CD Player to start the
audio CD application."
v.
"Click on Applications > Sound & Video > CD Player to start the audio CD
application."
And so forth.
However, a blanket rule to "never use 'you'" might be wrong. At the
least, we can discuss here what we want to do. Perhaps we can break
some new ground, or at least join the 21st century. ;-D
- Karsten
[1] Markestpeak == language used in marketing products/services, which
is deliberately personal
[2] Cheerleader-writing == my term for writing with lots of exclamation
points! You'll love it! Or not! But you just can't make it stop!
Yes, I used to edit my high school newspaper.
--
Karsten Wade, RHCE, 108 Editor ^ Fedora Documentation Project
Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject
quaid.108.redhat.com | gpg key: AD0E0C41
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL:
Hey, Fedora users! We are trying to figure out how many desktop users
we have. We are using a simple image to count the number of hits we get
from unique IP addresses. We are not tracking any identifiable
information.
This image right here:
...is being used for that purpose. If you see the image, that means
you are online, and you have been counted. If you do not see the image,
it is because you are offline, and the image cannot load.
Why is this important? Because we need to know how many users we have,
which helps help us fund innovations to Fedora.
> Hey, Fedora users! We are trying to figure out how many desktop users
> we have. We are using a simple image to count the number of hits we get
> from unique IP addresses. We are not tracking any identifiable
> information.
>
> This image right here:
>
> ...is being used for that purpose. If you see the image, that means
> you are online, and you have been counted. If you do not see the image,
> it is because you are offline, and the image cannot load.
>
> Why is this important? Because we need to know how many users we have,
> which helps help us fund innovations to Fedora.
> foo
lines are going to be changed in the old and new
content.
Thanks - Karsten
--
Fedora-trans-list mailing list
Fedora-trans-list at redhat.com
https://www.redhat.com/mailman/listinfo/fedora-trans-list
--
Karsten Wade, RHCE, 108 Editor ^ Fedora Documentation Project
Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject
quaid.108.redhat.com | gpg key: AD0E0C41
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL:
> Hey, Fedora users! We are trying to figure out how many desktop users > we have. We are using a simple image to count the number of hits we get > from unique IP addresses. We are not tracking any identifiable > information. >
>> This image right here: >
> >> ...is being used for that purpose. If you see the image, that means > you are online, and you have been counted. If you do not see the image, > it is because you are offline, and the image cannot load. >
>> Why is this important? Because we need to know how many users we have, > which helps help us fund innovations to Fedora. >
>> > Hey, Fedora users! We are trying to figure out how many desktop users > > we have. We are using a simple image to count the number of hits we get > > from unique IP addresses. We are not tracking any identifiable > > information. > >
> >> > This image right here: > >
> > > >> > ...is being used for that purpose. If you see the image, that means > > you are online, and you have been counted. If you do not see the image, > > it is because you are offline, and the image cannot load. > >
> >> > Why is this important? Because we need to know how many users we have, > > which helps help us fund innovations to Fedora. > >
> >