[HIG] [Fwd: [Fwd: DRAFT Human Interface Guide release (0.1)]]

[Calum Benson <calum benson sun com>]

Some comments from Pat Costello (Sun docs guy and co-author of the GNOME
Documentation Styleguide).

Cheeri,
Calum.


---

Subject: Re: [Fwd: DRAFT Human Interface Guide release (0.1)]

John et alia, 

My initial reactions to the draft HIG are as follows: 

- Structurally the document is good. A closer review might indicate one
or two 
new sections, but not much more than that. 

- The content is good and mostly relevant. I'd delete some text, but not
whole 
sections. 

- The document is wordy. Very wordy. Everywhere. 

- The information delivery in the document does not comply with the
GNOME 
Documentation Style Guide. 

- There are some inconsistencies with the GNOME Documentation Style
Guide. Not 
many, but some. 

- There needs to be more linkage with the GNOME Documentation Style
Guide, 
especially in terms of our Word List. Ideally, both guides should access
the 
same Word List. 

Ideally, I'd recommend a thorough edit plus the attentions of a real
writer. 
This document should be slick and fault-free. Professional.
User-friendly and 
accessible. We could achieve that with a rewrite and edit round. Given
the 
writing that is currently in the document, I doubt that the Usability
team would 
be able to achieve the desired level of clarity, without a lot of
effort. 

Anyone else have an opinion? How do we want to proceed? Discussion,
anyone? 

Pat

-- 
CALUM BENSON, Usability Engineer       Sun Microsystems Ireland
mailto:calum benson ireland sun com    Desktop Engineering Group
http://www.sun.ie                      +353 1 819 9771

Any opinions are personal and not necessarily those of Sun Microsystems

--- Begin Message ---

• From: Pat Costello <Patrick Costello Sun COM>
• To: calum benson ireserver Ireland Sun COM
• Subject: Re: [Fwd: DRAFT Human Interface Guide release (0.1)]
• Date: Tue, 18 Dec 2001 11:56:29 +0000 (GMT)

Calum, 

I sent the attached mail to the inner cabal of documentation teamers, meaning to 
forward it on to you at a later stage. I can't remember if I did so. Anyway, 
here is the mail.John and I already spoke to you briefly about this topic. You 
can discuss my comments with the HIG team if you want to. If the HIG team is 
interested in some writer support at a later stage, let me know and we'll see 
what we can do. 

Pat

------------- Begin Forwarded Message -------------

Subject: Re: [Fwd: DRAFT Human Interface Guide release (0.1)]
To: john.sheehan
Cc: eugene.oconnor, ireneryan eircom net
Mime-Version: 1.0
Content-MD5: PkLaBrG5Su3ZAJytuorXNw==

John et alia, 

My initial reactions to the draft HIG are as follows: 

- Structurally the document is good. A closer review might indicate one or two 
new sections, but not much more than that. 

- The content is good and mostly relevant. I'd delete some text, but not whole 
sections. 

- The document is wordy. Very wordy. Everywhere. 

- The information delivery in the document does not comply with the GNOME 
Documentation Style Guide. 

- There are some inconsistencies with the GNOME Documentation Style Guide. Not 
many, but some. 

- There needs to be more linkage with the GNOME Documentation Style Guide, 
especially in terms of our Word List. Ideally, both guides should access the 
same Word List. 

Ideally, I'd recommend a thorough edit plus the attentions of a real writer. 
This document should be slick and fault-free. Professional. User-friendly and 
accessible. We could achieve that with a rewrite and edit round. Given the 
writing that is currently in the document, I doubt that the Usability team would 
be able to achieve the desired level of clarity, without a lot of effort. 

Anyone else have an opinion? How do we want to proceed? Discussion, anyone? 

Pat


> X-Accept-Language: en
> MIME-Version: 1.0
> To: patrick costello Sun COM, irene ryan Sun COM, eugene oconnor Sun COM
> Subject: [Fwd: DRAFT Human Interface Guide release (0.1)]
> Content-Transfer-Encoding: 7bit
> 
> 
> 
> -------- Original Message --------
> Subject: DRAFT Human Interface Guide release (0.1)
> Date: 27 Nov 2001 05:07:52 -0800
> From: Seth Nickell <snickell stanford edu>
> To: gnome-hackers gnome org,Release the hounds! 
<gnome2-release-team gnome org>,gnome-2-0-list gnome org
> CC: Seth Nickell <snickell stanford edu>, hig gnome org
> 
> The HIG Team and the GNOME Usability Project are proud to release v0.1
> of the GNOME 2 Human Interface Guide (HIG). This is a draft release:
> some content is already slated to change or is not yet written, and
> there are relatively few illustrations. However, we felt it was
> important to start the public review process as early as possible. Thus
> while v0.1 is a little rough it should be complete enough to provide
> both a flavour of the final HIG and enough of a basis for critique.
> 
> Its available in HTML & PS at http://usability.gnome.org/hig
> 
> What is the GNOME 2 HIG? Excert from the introduction...
> 
> "This document tells you how to create applications that look right,
> behave properly, and fit into the Gnome user interface as a whole. It is
> written for interface designers, graphic artists and software developers
> who will be creating software for the Gnome environment. Both specific
> advice on making effective use of interface elements, and the philosophy
> and general design principles behind the Gnome interface are covered."
> 
> Release the hounds!
> 
> -Seth
> 
> _______________________________________________
> gnome-2-0-list mailing list
> gnome-2-0-list gnome org
> http://mail.gnome.org/mailman/listinfo/gnome-2-0-list

------------- End Forwarded Message -------------

--- End Message ---