Re: GNOME Manual of Style (was: GNOME vs. Gnome)

[John Fleck <jfleck inkstain net>]

On Wed, Oct 04, 2000 at 01:25:06AM -0500, Dan Mueth wrote:
> 
> I propose we get a team of people to create a "GNOME Manual of Style" and

Or would that be "Gnome Manual of Style"? :)

> then present it to this mailing list for discussion and modification if
> necessary.  It will require a fair amount of work as well as expertise.  
> So, I'd like to see at least two core GDP people in addition to a couple
> people who work with style guides in a corporate or professional setting.  
> I'm hoping a technical writer or editor from Sun and maybe somebody from
> Red Hat or any of the other GNOME Foundation companies would contribute.  
> Of course if any GDPers have a lot of experience with style guides, then
> that is even better.  John Fleck has already agreed to help, so we need
> one or two other core GDPers.
> 
> If anybody has expertise in this area and would like to help, I'd
> definitely like to hear from you.
> 

I think Dan's list of ideas is a great starting point.

There also is some very useful material written by Aaron in the GDP
Handbook that goes to the issue how to think about your audience, plan
and organize a manual and decide what to include and what to leave
out.

As Dan noted, I'll be happy to help develop this. I think it will be a
very useful exercise not only in providing a guide for writing docs,
but also in thinking through some of the issues about how best to
provide the most useful manuals possible to Gnome, err, I mean GNOME
users.

Cheers,
-- 
John Fleck
jfleck inkstain net (h)
jfleck abqjournal com (w)
http://www.inkstain.net/fleck/
http://www.abqjournal.com/scitech/