Usability] Word-a-Day (Terminology Recommendations)]]

Billy Cina billy.cina at canonical.com
Thu Apr 3 10:23:14 UTC 2008


Maybe something we can get involved with.

Best regards
Billy Cina

-------- Forwarded Message --------
From: Shaun McCance <shaunm at gnome.org>
To: gnome-doc-list at gnome.org
Cc: gnome-i18n at gnome.org, gnome-love at gnome.org,
desktop-devel-list at gnome.org, usability at gnome.org
Subject: [Usability] Word-a-Day (Terminology Recommendations)
Date: Wed, 02 Apr 2008 12:36:16 -0500

In an effort to revamp the terminology recommendations found in
our Documentation Style Guide, I'm starting a little initiative
I call Word-a-Day.  Basically, every day (more or less), I will
send a term or a group of related terms to gnome-doc-list for
discussion.

I've CC'd a number of mailing lists for this announcement, but
the actual Word-a-Day emails will be sent to gnome-doc-list only.
Please subscribe to gnome-doc-list if you want to participate.
This is an otherwise low-traffic mailing list.

I have a rough list of terms to filter through here:

http://live.gnome.org/DocumentationProject/Terminology/RoughList

These are not necessarily terms that will be recommended or
recommended against.  They're just terms I've come across in
various style guides and communications media.  If there are
terms you feel should be addressed, add them to this page
under the 'User Suggestions' section.

When I select a term or group of terms, I will put together
a tentative recommendation.  If I'm personally undecided,
I'll formulate multiple recommendations we can choose from.
I'll send that information to the list for discussion and
put the terms here:

http://live.gnome.org/DocumentationProject/Terminology

The 'Pending Terms' section will contain a list of terms
I've sent to the list, with a link to the mailing list
archive of the email.  Please do not edit this page.
Send your comments to the mailing list instead.

When a consensus has been reached, I'll move those terms
to the 'Completed Terms' section with the recommendations
we've agreed upon.

When this is all finished, I'll incorporate all the new
recommendations into the Style Guide.  This is the first
step in a revamp of the Style Guide.

For the curious, my plan is to change the GNOME Documentation
Style Guide to something more like the GNOME Manual of Style.
That is, it will contain language recommendations for both
documentation and user interfaces.  There may be sections
that deal specifically with documentation, if needed, but
the core of the document will not be documentation-specific.

--
Shaun


_______________________________________________
Usability mailing list
Usability at gnome.org
http://mail.gnome.org/mailman/listinfo/usability



-- 
Billy Cina
Training Programmes Manager
Dir: +44 207 630 2454
Mob: +44 780 938 9862
billy.cina at canonical.com
www.ubuntu.com






More information about the ubuntu-doc mailing list