sklarcorp / data-style-guide

Describes the standardized practices, grammar, and vocabulary for product data.
www.sklarcorp.com
1 stars 1 forks source link

Letter case (i.e. when to capitalize) #55

Closed mwmalinowski closed 10 years ago

mwmalinowski commented 10 years ago

[This is a spinoff of issue #51] "we should establish a rule regarding choice of letter case"


I try to use Title Case as much as possible

e.g.

However, in the fields Short Description and Description I'm more likely to use Sentence case because those fields are more likely to follow a paragraph format and incorporate existing marketing blurbs.

Admittedly, we should establish a rule regarding choice of letter case, but for the time being I recommend (as a rule of thumb) using Title Case for any phrase that is in our main attribute fields (i.e. fields other than Name, Short Description, and Description) regardless of what field that phrase is in.

To clarify: Angled (90 Degrees) uses Title Case because it's regularly used in our main attribute fields--therefore we should maintain Title Case for Angled (90 Degrees) even if it's in, say, Description.

We can use Sentence case for something like

Professional quality stainless steel utility scissors with a polished finish designed for everyday use.

because it never appear in our main attribute fields; it will only be in Description and/or Short Description.

sklar-sherryp commented 10 years ago

Why would Name not be considered a "main attribute field"?

Would it be less complicated to say: "Use Title Case in every field except..." and "In (specified fields) use Sentence Case"

sklar-sherryp commented 10 years ago

Added some details for when to use Title Case and when to use Sentence Case

mwmalinowski commented 10 years ago

@sklar-sherryp said: Why would Name not be considered a "main attribute field"?

I don't consider Name, Short Description, and Description as main attribute fields because their values are a conglomeration of other, more atomic fields.

sklar-sherryp commented 10 years ago

Closing this issue.