Technical writing for business people

Technical writing is about communicating key information to the people who need it. It might be a manual for an application, a guide to using heavy machinery, a diagnostic aide for medical practitioners or a guidance note about new legislation. It needs to be clear and it needs to be precise. This b...

Full description

Bibliographic Details
Other Authors: Marshall, Carrie, author (author)
Format: eBook
Language:Inglés
Published: Swindon, UK : BCS Learning & Development [2018]
Edition:1st edition
Subjects:
See on Biblioteca Universitat Ramon Llull:https://discovery.url.edu/permalink/34CSUC_URL/1im36ta/alma991009630542606719
Table of Contents:
  • Cover
  • Copyright Page
  • CONTENTS
  • LIST OF FIGURES
  • AUTHOR
  • PREFACE
  • 1 WHAT IS TECHNICAL WRITING?
  • THE TECHNICAL WRITER'S TOOLKIT
  • THE MOST IMPORTANT THING YOU NEED AS A TECHNICAL WRITER (AND NO, IT ISN'T A REALLY GOOD PEN)
  • KEY TAKEAWAYS
  • 2 SEVEN STEPS TO HEAVEN: THE TECHNICAL WRITING CYCLE
  • 1. SPECIFICATION, AUDIENCE AND SCOPE
  • 2. PLANNING
  • 3. RESEARCH AND WRITING
  • 4. TESTING, REVIEWING AND REVISION
  • 5. DELIVERY
  • 6. EVALUATION AND FEEDBACK
  • 7. REVISION, ARCHIVING OR DESTRUCTION
  • TECHNICAL WRITING IN A TEAM
  • A QUICK WORD ABOUT WRITING APPS
  • A QUICK WORD ABOUT FORMATTING TEXT
  • KEY TAKEAWAYS
  • 3 KNOW YOUR AUDIENCE
  • WHO ARE YOU WRITING FOR?
  • PERSONAS IN TECHNICAL WRITING
  • WHAT DO THEY ALREADY KNOW?
  • WHAT DO THEY NEED TO KNOW, AND WHY?
  • WHERE AND WHEN DO THEY NEED TO KNOW IT?
  • KEY TAKEAWAYS
  • 4 BREAK IT DOWN: THE IMPORTANCE OF A TASK-BASED APPROACH
  • BREAK IT DOWN (BUT NOT TOO MUCH)
  • THE OTHER BIG BENEFIT OF A TASK-BASED APPROACH
  • KEY TAKEAWAYS
  • 5 ASSUME NOTHING
  • MAKING ASSUMPTIONS
  • ASSUMPTIONS AND ACCESSIBILITY
  • JUNK THE JARGON, BANISH BUZZWORDS AND ABOLISH ACRONYMS
  • KEY TAKEAWAYS
  • 6 VANQUISH VAGUENESS
  • BE PRECISE
  • DON'T LEAVE WIGGLE ROOM
  • BE SPECIFIC
  • KEY TAKEAWAYS
  • 7 DON'T BE YOURSELF
  • THE IMPORTANCE OF CLARITY
  • KEY TAKEAWAYS
  • 8 STICK TO THE STORY
  • 1. LONG PARAGRAPHS
  • 2. DENSE BLOCKS OF TEXT
  • 3. IRRELEVANT OR USELESS GRAPHICS
  • 4. POOR PUNCTUATION
  • 5. TOO MUCH INFORMATION
  • 6. FORGETTING TO INCLUDE THE 'HOW'
  • 7. UNCLEAR NAVIGATION AIDS
  • KEY TAKEAWAYS
  • 9 BE ACTIVE: WHY YOU SHOULD AVOID THE PASSIVE VOICE AND WEAK VERBS
  • WHY WEAK WORDS MAKE WRITING WORSE
  • KEY TAKEAWAYS
  • 10 DIAGRAMS, LISTS AND GRAPHICS
  • LISTY BUSINESS
  • GO WITH THE FLOW (CHART)
  • OTHER KINDS OF CHARTS
  • KEEP AWAY FROM THE CLIPART
  • GOOD GRAPHICS
  • KEY TAKEAWAYS.
  • 11 EVERYBODY NEEDS AN EDITOR
  • LET GO OF YOUR EGO
  • WHAT TO LOOK FOR WHEN YOU'RE EDITING
  • ACCURACY
  • SIMPLICITY
  • BREVITY
  • EFFECTIVENESS
  • SHEER TEDIUM
  • KEY TAKEAWAYS
  • 12 THE TECHNICAL WRITING HOUSE OF HORRORS
  • WHEN COMMAS COST
  • THE CONVERSION THAT COST A SPACESHIP
  • THE 'S' THAT KILLED A COMPANY
  • WHEN XXX COSTS
  • THE £52 MILLION COMMA
  • AFTERWORD
  • INDEX
  • Back Cover.