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.
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)
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.
Whenever possible, use the longer version of a term for clarity.
- Use “telephone” not “phone”
- Use “operating system” not “system”
- Use “Newton device” not “Newton”
- Use “Newton OS” not “NOS”
Referring to other terms
- Use “Also referred to as …” if the referenced term is as common or less common than the source term.
- Use “Commonly referred to as …” if the referenced term is more common than the source term.
- Use “Mistakenly referred to as …” if the referenced term is an commonly misspelled or mangled version of 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?
Ink words are created when the user has selected Ink Text in the “Recognition Preferences” slip.
When linking to the main page of a website, include both the website name and “Website” as part of the link text.
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.
- Apple: The NewtonScript Programming Language (PDF)
- Catamount Software: Handwriting Tips for Newton Power Users
- UNNA: The NewtonScript Programming Language (PDF)
- Wikipedia: GeoPort
If the link points to an Internet Archive mirror of the original website, article, or resource, prefix the link text as such.