[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
Re: [platform-doc-dev] Capitalization
|
I agree these should be capitalized since they are all part of the name.
Debbie Wilson/Ottawa/IBM@IBMCA
Sent by: platform-doc-dev-admin@xxxxxxxxxxx
03/18/2003 02:34 PM
Please respond to platform-doc-dev
To: platform-doc-dev@xxxxxxxxxxx
cc:
Subject: Re: [platform-doc-dev] Capitalization
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.