Re: [HIG] Mini-Guidelines content
- From: Adam Elman <aelman users sourceforge net>
- To: colin z robertson <c z robertson ndirect co uk>
- Cc: hig gnome org
- Subject: Re: [HIG] Mini-Guidelines content
- Date: Mon, 20 Aug 2001 00:16:37 -0700
All right, I don't feel _too_ strongly about this either way.
Let's take the below outline as a set of "suggested guidelines" and,
if we need to tighten the format as we actually produce content, we
can reevaluate this in, say, two or three weeks.
Any objections? If not, let's just go ahead and start writing that content! :)
P.S. I'll be offline for most of the next couple of days, but should
be back online by Wednesday.
At 5:12 PM +0100 8/19/01, colin z robertson wrote:
On Thu, Aug 16, 2001 at 11:41:53AM -0700, Adam Elman wrote:
>For example, on the last set of guidelines I worked on, each sub-topic
>followed something like this format:
>Description of sub-topic (1 paragaph)
>Further description of diagram if required (max. 2 paragraphs)
>Bulleted list of "required" guidelines
>Bulleted list of "optional" guidelines
>More detailed explanation of guidelines, including further tables and
>diagrams if necessary (max. 1 page)
This works for me. Any objections to this basic format?
Well, I'm not sure that things actually need to be specified in this
way. Looking through other style guides, I haven't seen any that have
such a uniform structure as this.
Different subjects have different formatting requirements. The
standard menus section will inevitably be a long list of menu items
and descriptions of their behaviour, while the dialog principles
section will be a less structured set of guidelines which will require
Certainly we should try very hard to ensure that our work is readable,
but I'm not sure that a one-size-fits-all approach is the best way to
Colin, can we work this into a docbook template?
Should be possible, if we agree to this format.
How far is this
from the current format? (I haven't had a chance to look at the
document you posted; I'll do that in the next hour or so.)
The current template is very minimal. It doesn't specify anything
other than the chapters we agreed upon. The only work that's in there
at the moment is my own, and that's just taken straight from the
dialogs and menus stuff that I'd already done.
rtnl http://rational.cjb.net c z robertson ndirect co uk
Attachment converted: Don't Panic!:Untitled 18 (????/----) (00076C99)
] [Thread Prev