Apart from the question of "what name to use", the "single point of definition" pattern is good. One consistent name for an item, with a link to the definition - then if the appearance or location of the item changes, the definition only needs to be updated in one place, and voila! the docs are still good.
- Josh ~ Kirtan is Life! ~ Sent from my iPhone. On 06/07/2011, at 1:48 AM, Matthew East <[email protected]> wrote: > On 5 July 2011 14:52, Shaun McCance <[email protected]> wrote: >> On Tue, 2011-07-05 at 08:54 -0400, Dan Winship wrote: >>> 1a. FWIW, Ubuntu users almost universally refer to it as "the me >>> menu" >> >> Not surprising. Absent other terms being given to them, people will >> just use the names of the closest thing they can find. The user menu >> has aspects of both the me menu and the power menu though. > > Just as a clarification, I think that this terminology is used because > the designers/developers coined it, rather than the users. > > https://wiki.ubuntu.com/MeMenu > > In Ubuntu's help, it is occasionally referred to using that name with > a hyperlink to an explanation of the menus and their names (e.g. > https://help.ubuntu.com/11.04/ubuntu-help/net-chat-social.html). But I > don't think that the Ubuntu documentation team evolved a fixed policy > for this type of thing. We had a discussion similar to this one in > relation to the so-called "Session Menu" > (https://lists.ubuntu.com/archives/ubuntu-doc/2011-April/015640.html) > although I don't think a conclusion was reached or a decision taken. > > -- > Matthew East > http://www.mdke.org > gnupg pub 1024D/0E6B06FF > _______________________________________________ > gnome-doc-list mailing list > [email protected] > http://mail.gnome.org/mailman/listinfo/gnome-doc-list > > _______________________________________________ gnome-doc-list mailing list [email protected] http://mail.gnome.org/mailman/listinfo/gnome-doc-list
