[General] Launch page for Screencasts
Philippe Bossut
pbossut at osafoundation.org
Sat Aug 25 15:16:53 PDT 2007
Hi,
Mimi Yin wrote:
> It includes a brief glossary at the top and more descriptive titles
> for the movies as promised.
>
> Are there terms missing from the glossary? (This abbreviated glossary
> should probably link to Pieter's more complete glossary in the Get
> Started Guide.)
The idea of a glossary is to translate jargon in plain English. Jargon
is good as it allows to manipulate one complex new concept using one
single convenient word. However, explaining jargon with more jargon is a
put off for readers. In a glossary, we should:
- use only Webster certified words. Avoid things like "affordance" which
is UI expert jargon, not an English word that a lay person would
understand.
- when defining something the first sentence must be a direct statement
with the thing to define as the subject, e.g.: "A <XYZ> is a <plain
English>". Explaining "item" for instance by saying that Chandler offers
4 different kind of them doesn't really help the reader.
I can make a short rewrite if its ok with you.
Cheers,
- Philippe
More information about the General
mailing list