Professional Documents
Culture Documents
Writing Web
Writing Web
Writing guidelines
Guidelines for effective communication:
• Use clear, simple, familiar language.
• Avoid jargon, acronyms, and abbreviations.
• Use an active and objective voice.
• Be direct and concise, getting quickly important points.
• Put the conclusion first so readers know what to expect from the content.
Chunk content
• Chunk means a manageable bit—a small piece of information a user can easily find and understand.
• Bold important words or phrases.
• Use lists.
Titles
The title is the first piece of information a user scans. Make it clear, inviting, and meaningful.
Lists
• Lists are easy to scan because content is vertical.
• Content presented in lists is usually more succinct.
Links
• Link to related information.
• Use descriptive link text so users know where they are going.
Design elements
• Use callouts, bold, and italics to make text easier to scan.
• Substitute pictures and other visual elements for text when appropriate.
Best practices
• Analyze and emulate great web writing.
• Provide accurate descriptions and keywords for search engines.
• Use web writing guidelines when re-purposing print documents for the web.