Newton Glossary

An almost definitive guide to Newton-related terms and trivia.

Style Guide

Abbreviations (used as a “see also” pointing at expanded term)

Only include the abbreviated term in the related terms of the expanded term. Do not include the abbreviated term in other terms.

For example, Newton Toolkit should list NTK as a related term because it is the actual abbreviation for Newton Toolkit.

However, project build should list Newton Toolkit, not NTK.

Abbreviations (more common than the expanded term)

For example, PCMCIA is an acronym that is more commonly used than its expanded variation — Personal Computer Memory Card International Association. In this case, the expanded term would be included as the first part of the abbreviation’s entry.

Shortened terms

Whenever possible, use the longer version of a term for clarity.

Examples:

Referring to other terms

Examples:

Use if the referenced term is as common or less common than the source term. In some cases, such as a nickname or alternate spelling, the more personal phrase “Also known as …” can be used.

Use if the referenced term is more common than the source term.

Use if the referenced term is an commonly misspelled or mangled version of the source term.

Use if the referenced term is a quirky or derogatory name for the source term.

Capitalization of terms

Indicating menu items, windows, slips, and other named user interface elements

Other than using their proper capitalized names, should these items be wrapped in quotes or styled in some other way?

Example:

Introducing descriptive elements of a term

Do not use generic nouns such as “kind” when introducing a descriptive element relating to a terms.

Example:

Instead, use a more specific noun.

Examples:

Hyphenated terms

Minimize the use of subjective hyphenated terms.

Examples:

Acceptable hyphenated terms include:

Miscellaneous considerations

When describing the effects of an action, use the more enabling term “can” rather than “may”.

Example:

Links to additional information

When linking to the main page of a website, include both the website name and “Website” as part of the link text.

For example:

When linking to a specific article or resource on a website, use the full name or title of the article or resource — prefixed with the source website — as the link text.

For example:

If the link points to an Internet Archive mirror of the original website, article, or resource, prefix the link text as such.

For example: