Re: Style of Comment[xx]=blah blah blah.<- the dot

[Karl Eichwalder <keichwa gmx net>]

Gediminas Paulauskas <menesis delfi lt> writes:

> from gnome-libs/devel-docs/suggestions.txt:
> 
>  - Your menu hints should not have a trailing period.  They should be
>    phrased like commands, e.g. "Open a new file".  Do NOT phrase them
>    like a description, e.g. "Opens a new file".
> 
> I think the same rule applies to Comment[xx], because these all basically
> are tooltips.

The rule should be changed, please:

From: John Sullivan <sullivan eazel com>
Subject: Re: Tooltips, Labels, and the Dots
To: Karl Eichwalder <ke gnu franken de>, <gnome-gui-list gnome org>
Date: Sat, 27 May 2000 09:37:03 -0700

on 5/27/00 8:55 AM, Karl Eichwalder at ke gnu franken de wrote:

> John Sullivan <sullivan eazel com> writes:
> 
>> That should depend on the phrasing.
> 
> Okay.  How should one phrase tooltips?  I hear your answer: "Short" ;)
> 
>> If the tooltip is a complete sentence, it should end with a period. If
>> it is a noun phrase, it shouldn't. Perhaps you're arguing that all
>> tooltips and check boxes should contain complete sentences?
> 
> I'm not sure.  "Print preview" is okay.  So is "Undo the operation" --
> qualifies "Undo the operation" as a complete sentence?  (Examples from
> gnumeric.)
> 
> It sounds reasonable: Incomplete "sentences" (phrases) don't need dots.
> I'd like to add the a further rule: If an application has one long
> tooltip (= sentence with a dot) all tooltips -- even the short ones --
> should have dots (if conformity is a goal).

I would phrase that a little differently. All the tooltips for an
application should use the same style, whether that is noun phrases or
complete sentences. I haven't thought long enough about this to recommend
one or the other at this time. But in your gnumeric examples, "Print
preview" is a noun phrase (though "preview printing" is a complete sentence)
and "Undo the operation" is a complete sentence. These are inconsistent and
one or the other should be changed.

John


-- 
work : ke suse de                          |          ------    ,__o
     : http://www.suse.de/~ke/             |         ------   _-\_<,
home : keichwa gmx net                     |        ------   (*)/'(*)