User Guide Instructions

User Guides, Manuals, and Technical Writing

This book is intended for anyone whose job involves writing formal documentation. It is aimed at non-native speakers of English, but should also be of use for native speakers who have no training in technical writing. Technical writing is a skill that you can learn and this book outlines some simple ideas for writing clear documentation that will reflect well on your company, its image and its brand. The book has four parts: Structure and Content: Through examples, you will learn best practices in writing the various sections of a manual and what content to include. Clear Unambiguous English: You will learn how to write short clear sentences and paragraphs whose meaning will be immediately clear to the reader. Layout and Order Information: Here you will find guidelines on style issues, e.g., headings, bullets, punctuation and capitalization. Typical Grammar and Vocabulary Mistakes: This section is divided alphabetically and covers grammatical and vocabulary issues that are typical of user manuals.

Open Technical Communication

"Technical communication is the process of making and sharing ideas and information in the workplace as well as the set of applications such as letters, emails, instructions, reports, proposals, websites, and blogs that comprise the documents you write...Specifically, technical writing involves communicating complex information to a specific audience who will use it to accomplish some goal or task in a manner that is accurate, useful, and clear. Whether you write an email to your professor or supervisor, develop a presentation or report, design a sales flyer, or create a web page, you are a technical communicator." (Chapter 1)

NIOSH Manual of Analytical Methods: Method finder, user's guide, methods A-D