Defining Terms Writing for the Web The Internet Writer’s Handbook 2/e

Contents Definitions Glossary

Definitions The Internet Writer’s Handbook 2/e

Types of Definitions: Informal Informal: synonym, simpler word or phrase Example: The CPU, or Central Processing Unit, tells ...

Types of Definitions: Formal Formal definition CLASS + DIFFERENTIA (how it differs from other items in the class)

Ways to Signal a Simple Definition Signal words: is, refers to, is called, or ( ) parentheses -- dashes

Ways to Signal a Simple Definition , , clause Bold Italics

How Often to Define Define the term the first time it appears on a page. For long Web pages, define terms at the beginning of the page or link to a glossary.

Errors in Writing Definitions Circular definitions Terms more difficult than the original word Use of “is when” Being too narrow or too broad

Places to Put Definitions In text itself: when central to your discussion In sidebar or shaded box In frame At end of page In separate window In glossary

Glossary The Internet Writer’s Handbook 2/e

Linking to Glossary Links to glossary within text Glossary link on navigation bar

Sample: Links to Definitions

Glossary With Internal Links

Glossary With Frames