Home Library Translate
A A A
Share »
Follow us on Facebook Follow us on Twitter Follow us on LinkedIn
Connect »

Blog: Business Communications

Menu

  • This Blog's Home
  • Guest Writer Submissions
  • Policies
  • To Subscribe to a Blog
  • About
  • Feedback

Tips To Get Your Document Read

By Theresa Pojuner on November 2, 2011

Technical Writers do more than just write. They communicate relevant technical information to get jobs done; see previous posts on what a Technical Writer does (see Defining a Technical Writer). They create the documentation, but how do they present an effective and appealing document?  In a previous post, we discussed how to create a Style Guide and the importance of them. The guide allows the writer to focus on writing the content, and less on the look and feel of the document. No matter which Style Guide is followed, there are certain popular generic rules that should be followed. You might say the items mentioned below, can be part of a Style Guide.

To increase the visual appeal of a document, we should adhere to certain rules the same way we do for grammar. If the document is too long, does not present any illustrations, and is strictly text, the user will have a problem just reading the first page. Readers will usually flip through the document to see how it is structured. If it has a lot of white space, images, and has varying styles and formats, then viewers will more likely read it. Apply some of the following tips:

  • Insert images; use plenty of graphics; snapshots, tables, and charts to aid in explanations.
  • Use pointers, callouts, or arrows pointing to each part of an active item.
  • Organize document with easy to find information; use plenty of pointers, references, tips, thumbnails, etc to guide the reader.
  • Make paragraphs short and succinct; use simple words and write for the audience.
  • Use icons indicating relevant-must know information; warnings, advice, rules, policies, etc.
  • Ensure plenty of white space.
  • Do not create lengthy documents; break it up into more than one.
  • Limit varying fonts and colors for pointing out information.
  • Use outlines, bullets, etc., for ease of readability.
  • Apply headers and footers.
  • Include Glossary, Table of Contents, Appendix, Index, Error section, Check List, or Reference sheet/card if applicable.
  • Include a Q&A section.
  • When instructing, create numerical step-by-step directions and include indented sub-levels if appropriate.
  • Change up the style from one section to another, e.g., from one column to two, or have text flow around images for a change.

Try to create a visually appealing document using some of the above ideas. If you have more suggestions or ideas on how to make documentation more appealing, please leave a comment.

« Previous Next »

Search Our Site

Meet This Blog’s Host

Gail Zack Anderson, President of Applause, Inc., has nearly 20 years experience in training and coaching. She provides individual presentation coaching, and leads effective presentation workshops and effective trainer workshops. [Read more ...]


Theresa Pojuner is a Documentation Specialist with over 20 years of writing experience and is skilled in many areas of documentation, for example, Style Guides, Training Manuals and Test Cases, wth a specialty n Technical Writing and Procedures. [Read more ...]

Recent Blog Posts
Alternate Recent Posts Widget

  • Becoming A Technical Writer-Communicator Review
  • Creating A Knowledge Community
  • Tips for Handling Technical Writer Stress
  • Likeminded Communication
  • A Technical Writer Is Different From Other Writers
  • Involve and Engage Your Audience 20 Ways
  • Tips On Documenting Processes
  • Communicating Technical Writing Review
  • Communicating Via Visual Designs
  • Special Tips for Laptop Presentations

Related Library Topics

  • Body Language
  • Netiquette

Categories of Posts

  • Basics and Overviews
  • Body Language
  • Communicating Change
  • Communication Best Practices
  • Feedback (Sharing)
  • Humor in speaking
  • images
  • Listening
  • Netiquette
  • Presenting
  • slide shows
  • Speaking Skills
  • Team Presentations
  • technical writing
  • Telephone Skills
  • Uncategorized
  • Visual Aids
  • Voice and Vocal Habits
  • Writing

Library's Blogs

  • Boards of Directors
  • Building a Business
  • Business Communications
  • Business Ethics, Culture and Performance
  • Business Planning
  • Career Management
  • Coaching and Action Learning
  • Consulting and Organizational Development
  • Crisis Management
  • Customer Service
  • Facilitation
  • Free Management Library Blogs
  • Fundraising for Nonprofits
  • Human Resources
  • Leadership
  • Marketing and Social Media
  • Nonprofit Capacity Building
  • Project Management
  • Quality Management
  • Social Enterprise
  • Spirituality
  • Strategic Planning
  • Supervision
  • Team Building and Performance
  • Training and Development
About Feedback Legal Privacy Policy Contact Us
Free Management Library, © Copyright Authenticity Consulting, LLC ®; All rights reserved.
  • Graphics by Wylde Hare LLC
  • Website maintained by Caitlin Cahill

By continuing to use this site, you agree to our Privacy Policy.X