Everand Logo

Welcome to Everand!

  • Discover millions of ebooks, audiobooks, and so much more with a free trial

    Only €10,99/month after trial. Cancel anytime.

    Technical Writing for Business People
    Technical Writing for Business People
    Technical Writing for Business People
    Ebook128 pages1 hour

    Technical Writing for Business People

    By Carrie Marshall

    ()

    Read preview

    About this ebook

    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, or a diagnostic aide for medical practitioners. It needs to be clear and it needs to be precise. This book shows you how to achieve this and more. Whatever the content or context, in this book you’ll discover the essential tools and resources that you need to create technical writing that works for everyone.
    LanguageEnglish
    PublisherBCS, The Chartered Institute for IT
    Release dateSep 6, 2018
    ISBN9781780174488
    Technical Writing for Business People
    Author

    Carrie Marshall

    Carrie is a writer, broadcaster and musician from Glasgow. She’s the singer in Glaswegian rock band HAVR, a familiar voice on BBC Radio Scotland and has been a regular contributor to all kinds of magazines, newspapers and websites for more than two decades. She has written, ghost-written or co-written more than a dozen non-fiction books, a radio documentary series, and more.

    Read more from Carrie Marshall

    Related to Technical Writing for Business People

    Related ebooks

    Computers For You

    View More
    View More

    Related podcast episodes

    Related articles

    • Article

      Join The Revolution

      Nov 4, 2022

      Join The Revolution
      8 min read

    • Article

      Software’s Insatiable Appetite

      Jun 30, 2021

      It’s the sharemarket segment that is both all-inclusive and simultaneously hard to define: technology. I mean, we know it when we see it, but what is it, exactly? In the early 1910s, cars were “technology”. In the ’50s and ’60s, so were photocopiers.

      2 min read

    • Article

      Learning to Love What I Don’t Know

      Nov 1, 2017

      LIKE MANY WHO HAVE made the leap into Startupland, I guessed from the outset that I had a lot to learn. I was right. Indeed, I jumped into the wormhole of blind spots and unknown unknowns. This has been especially true on matters technological. At Io

      2 min read

    • Article

      Real-World Experience

      Jan 30, 2019

      Richard Millson often seems like the smartest guy in the room. There’s a confidence, bordering on arrogance, sure, but he’s not one of those people who thinks he has all of the answers but turns out to be all bluster. Millson actually seems to know a

      6 min read

    • Article

      Digital Trust Is On The Horizon

      Mar 1, 2022

      Digital Trust Is On The Horizon
      11 min read

    • Article

      Brain Trust

      Nov 11, 2019

      Brain Trust
      4 min read

    • Article

      The Innovative Enterprise

      May 1, 2020

      You work for one of the most creative companies in the world. How would you describe Cirque du Soleil’s approach to innovation? Our innovation is not the result of a few isolated actions. It’s part of our DNA. We challenge ourselves to never do the s

      5 min read

    • Article

      What AI Is Doing For Business

      Apr 22, 2019

      What AI Is Doing For Business
      5 min read

    • Article

      Over The Edge

      Nov 19, 2019

      Over The Edge
      9 min read

    • Article

      Playing Their Part

      Jun 9, 2019

      Playing Their Part
      5 min read

    • Article

      Taming Your Tech Talent

      Mar 1, 2017

      ETELKA LEHOCZKY WHEN ANASTASIA LENG QUIT Google to start Hatch.co, a shopping site for handmade goods, in 2012, one of the skills she’d developed at the tech giant proved crucial. Managing some of the world’s best IT talent gave the marketing specia

      2 min read

    • Article

      Corning Brings AI Hardware To Life

      Jul 26, 2024

      While many growth investors buy into the promise of artificial intelligence (AI) through mega-cap players such as Nvidia, Microsoft and Meta, companies whose products are necessary for building the supporting infrastructure are often overlooked. One

      2 min read

    • Article

      Confessions Of A Technophobe

      Jul 20, 2022

      Welcome to our 2022 ‘Technology Edition’, in which we explore new business technologies, their creators and their application. We trust you'll find our selection of tech-related stories useful. When it comes to technology, I must admit that I’m a bit

      1 min read

    • Article

      Before You Buy That Phone, Our Readers Need To Have A Word

      Oct 8, 2020

      @ PC PRO FACEBOOK.COM/PCPRO “TO IGNORE ONE informed PC Pro reader may be regarded as misfortune; to ignore two looks like carelessness.” With huge apologies to Oscar Wilde, that is the best way I can conceive to explain the importance of being earnes

      2 min read

    • Article

      You’d Better Get Write on It

      May 23, 2018

      In March 2010, Foursquare was riding high, one of the coolest social startups of the day, with gobs of fresh venture capital and a million people using its mobile app to check in. And then, on March 26, the company’s website went dark. Somebody, it s

      2 min read

    • Article

      Click Go The Years

      Jul 3, 2019

      Click Go The Years
      4 min read

    • Article

      Stay Ahead in Turbulent Times

      Aug 2, 2019

      How do you stay ahead of your competition is a question we strive to answer in each edition of The European Business Review. In today’s fast-changing and hyper-competitive digital age, this question becomes more important than ever before. With the e

      2 min read

    • Article

      “This Was Weaponised Technobabble. And They Were Bringing Out The Big Guns”

      Dec 7, 2023

      I’m not claiming that I manifested the glitch in the Air Traffic Control system at the end of the summer because I’m so deeply attuned to the natural and digital world that my worries actualised as a blip on the radar. But I might have done. Fortune,

      6 min read

    Related categories

    Reviews for Technical Writing for Business People

    0 ratings

    0 ratings0 reviews

    What did you think?

    Tap to rate

    Review must be at least 10 words

      Book preview

      Technical Writing for Business People - Carrie Marshall

      BCS, THE CHARTERED INSTITUTE FOR IT

      BCS, The Chartered Institute for IT, champions the global IT profession and the interests of individuals engaged in that profession for the benefit of all. We promote wider social and economic progress through the advancement of information technology science and practice. We bring together industry, academics, practitioners and government to share knowledge, promote new thinking, inform the design of new curricula, shape public policy and inform the public.

      Our vision is to be a world-class organisation for IT. Our 70,000-strong membership includes practitioners, businesses, academics and students in the UK and internationally. We deliver a range of professional development tools for practitioners and employees. A leading IT qualification body, we offer a range of widely recognised qualifications.

      Further Information

      BCS, The Chartered Institute for IT,

      First Floor, Block D,

      North Star House, North Star Avenue,

      Swindon, SN2 1FA, United Kingdom.

      T +44 (0) 1793 417 424

      F +44 (0) 1793 417 444

      www.bcs.org/contact

      http://shop.bcs.org/

      © 2018 BCS Learning & Development Ltd

      The right of Carrie Marshall to be identified as author of this Work has been asserted by her in accordance with sections 77 and 78 of the Copyright, Designs and Patents Act 1988.

      All rights reserved. Apart from any fair dealing for the purposes of research or private study, or criticism or review, as permitted by the Copyright Designs and Patents Act 1988, no part of this publication may be reproduced, stored or transmitted in any form or by any means, except with the prior permission in writing of the publisher, or in the case of reprographic reproduction, in accordance with the terms of the licences issued by the Copyright Licensing Agency. Enquiries for permission to reproduce material outside those terms should be directed to the publisher.

      BCS and the BCS logo are the registered trade marks of the British Computer Society, charity number 292786 (BCS).

      Published by BCS Learning & Development Ltd, a wholly owned subsidiary of BCS, The Chartered Institute for IT, First Floor, Block D, North Star House, North Star Avenue, Swindon, SN2 1FA, UK.

      www.bcs.org

      Paperback ISBN: 978-1-78017-4464

      PDF ISBN: 978-1-78017-4471

      ePUB ISBN: 978-1-78017-4488

      Kindle ISBN: 978-1-78017-4495

      British Cataloguing in Publication Data.

      A CIP catalogue record for this book is available at the British Library.

      Disclaimer:

      The views expressed in this book are of the author(s) and do not necessarily reflect the views of the Institute or BCS Learning & Development Ltd except where explicitly stated as such. Although every care has been taken by the authors and BCS Learning & Development Ltd in the preparation of the publication, no warranty is given by the authors or BCS Learning & Development Ltd as publisher as to the accuracy or completeness of the information contained within it and neither the authors nor BCS Learning & Development Ltd shall be responsible or liable for any loss or damage whatsoever arising by virtue of such information or any instructions or advice contained within this publication or by any of the aforementioned.

      Publisher’s acknowledgements

      Reviewers: Oliver Lindberg and Cliff Hobbs

      Publisher: Ian Borthwick

      Commissioning Editor: Rebecca Youé

      Production Manager: Florence Leroy

      Project Manager: Sunrise Setting Ltd

      Cover work: Alex Wright

      Picture credits: DenisProduction.com / Shutterstock

      Typeset by Lapiz Digital Services, Chennai, India.

      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

      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.

      Enjoying the preview?
      Page 1 of 1