search

splorp / newton-glossary

An almost definitive guide to terms and trivia related to the Apple Newton.
9 stars 4 forks source link

Determine case of linked terms in glossary entries #3

Closed splorp closed 2 months ago

splorp commented 10 years ago

Should terms that are linked within the body of a glossary definition use title case or sentence case?

For example:

To make a container view go away by tapping the close box.

vs.

To make a Container View go away by tapping the Close Box.

morgant commented 10 years ago

That's a tough one. How many terms are proper nouns or themselves are title case (like "NewtonScript")? Visually, I lean toward title case as it stands out more and is the topic of the target link; logically, I lean toward sentence case because the sentence would be correct we're the links removed and that it might diminish proper nouns and title case terms.

splorp commented 10 years ago

Sentence case is making the most sense for me, other than for terms that include product or code names (eg: MessagePad and proper nouns (eg: Area 51).

If having the links terms stand out a bit more is a requirement, we can do that via CSS.

morgant commented 10 years ago

Sounds great, and exactly my thoughts on improving visibility through styling.

splorp commented 2 months ago

Addressed in the Style Guide under the subheading “Capitalization of terms” per commit a89cfc9