Call for review - chat and social networking section

[Matthew East]

On 25 April 2011 23:58, Jeremy Bicha <jeremy at bicha.net> wrote:
> On 25 April 2011 18:43, Jim Campbell <jwcampbell at gmail.com> wrote:
>> I liked how you used, "what's this?" to link to a possibly-unfamiliar term.
>> What do other people think about this? We don't normally use contractions,
>> but I feel ok with using one in those cases.
>
> While "what's this?" looks cool, it's like a tooltip that can't be
> turned off. Since this is web-like content, we can just use a normal
> hyperlink. Just my opinion.

I agree - and in fact changed to hyperlinks in revision 1501.

I do think that explaining unfamiliar terms is important, and I think
that using the terms can be important too. These are terms which the
designers have specifically created for users, not just for
developers, and which are used around the internet on a regular basis,
and part of our job when writing help is to teach users, as well as to
help them. Even if a user goes to the help to look at one page at a
time, we can still achieve that by using linking to allow them to
discover what different terms mean. Next time they come to the help,
they will know what that term is and won't need to follow the
hyperlink.

-- 
Matthew East
http://www.mdke.org
gnupg pub 1024D/0E6B06FF