Re: [platform-doc-dev] Capitalization

["Debbie Wilson" <Debbie_Wilson@xxxxxxxxxx>]

Another case of capitalization of proper nouns occurs with the names of some of our components.  I have just changed one document that had the following:
<b> Standard Widget Toolkit</b> (SWT)
<b> JFace</b> UI
Java development tooling (JDT)
Plug-in Development Environment (PDE)

I have changed these to all use the same style: get rid of the bold and capitalize each word.

Standard Widget Toolkit (SWT)
JFace UI
Java Development Tooling (JDT)
Plug-in Development Environment (PDE)

                            Deb

John Arthorne/Ottawa/IBM@IBMCA Sent by: platform-doc-dev-admin@xxxxxxxxxxx 03/18/2003 01:44 PM Please respond to platform-doc-dev

To:        platform-doc-dev@xxxxxxxxxxx         cc:                 Subject:        [platform-doc-dev] Capitalization

Another area where there is inconsistency is in capitalization.  Most section titles in the table of contents and headings within pages are sentence case, but some aren't.  I've been converting everything to sentence casing wherever I've seen inconsistencies, but I wanted to make sure we agree on it. 

A much trickier case is proper nouns.  I believe things like "Tasks View", "File Menu", and "Export Wizard" are all proper nouns, and as such both words should always be capitalized.  The documentation more commonly uses "Tasks view", "File menu", and "Export wizard", but I think this is not correct.  Correct me if I'm wrong here, but unless I hear otherwise I'll correct these problems where I see them.