Re: Common Vocabulary

[Shaun McCance <shaunm gnome org>]

On Sun, 2011-12-18 at 16:47 +0100, Milo Casagrande wrote:
> Hello everyone,
> 
> I was working on updating Empathy help, but there are a couple of
> questions I have.
> Do we have a common vocabulary or a common way to describe the new UI
> elements introduced with the new interface?

We've been working on a new style guide on and off. It's not really
ready, and doesn't answer any of your questions. But it has some
info on common terminology and instructions.

http://git.gnome.org/browse/gnome-devel-docs/tree/style-guide

> I'm referring in particular to the ON/OFF switch, and the +/- buttons
> to add and remove accounts.
> On the wiki I couldn't find anything about that, nor here in mailing
> list searching in the old discussions.
> 
> For the +/- button, should we use the images instead like we do with
> other buttons?
> For the ON/OFF switch, I used something along the line of "switch it
> on/off", but do we have something else?


For the switch, I refer to it like this:

* Switch <gui>Bluetooth</gui> on.
* Switch <gui>Bluetooth</gui> off.

It's the simplest, most direct way I can think of.

For the +/- buttons, I've been using just the + and - characters
in <gui> tags. I'm not entirely happen with that.

I would say we should take the accessible name into account, but
many of these +/- buttons don't have accessible names right now:

https://bugzilla.gnome.org/show_bug.cgi?id=660023

I'm open to suggestions.

--
Shaun