Document Conventions
This guide conforms to a set of conventions that attach specific meanings to typefaces used in explanations and procedures. The following table defines each of these conventions.
|
Item |
Convention |
Explanation / Example |
|---|---|---|
|
Acronyms |
All uppercase; usually spelled out on first use. |
Customer Care Framework (CCF) |
|
Book titles |
Title caps, italic. |
See the Visual Basic Custom Control Reference. |
|
Chapter titles |
Title caps, in quotation marks. |
See Chapter 9, "Extending Forms." |
|
Code samples |
Monospace. |
Void main () |
|
Command-line commands and options (switches) |
All lowercase, bold. |
copy command /a option |
|
Commands on menus |
Bold. |
File menu |
|
Dialog box options |
Bold |
Click Continue. |
|
Dialog box titles |
Bold |
Find and Replace dialog box. |
|
Directory names |
Initial capitalization; internal capitalization can be used for readability |
\\Irstaxforms\audit \\IRSTaxForms\Audit |
|
Emphasis or new words |
Italic. |
The software includes both client and server components. |
|
Error message names |
Sentence-style capitalization |
Access denied. |
|
File names |
Title capitalization; internal capitalization (camel casing) can be used for readability. |
Filename.doc FileName.doc |
|
Folder and directory names |
Bold in procedures; regular font elsewhere |
Open the NewDocs folder. \\Accounting\Payroll\Overtime |
|
Menu names |
Bold, title capitalization |
On the File menu… |
|
Parameters |
Italic |
CFFagentname |
|
Programming elements (API names, methods, classes, directives, functions, and so on) |
Bold in text; monospace in examples |
filebuf |
|
Program names |
Title capitalization |
Microsoft Word |
|
URLs |
Lowercase |
http://msdn.microsoft.com |
|
Windows, named |
Title caps |
Help window. |
|
Windows, unnamed |
Lowercase |
document window |