Writing as a career
       Ellis Pratt
     cherryleaf.com
Overview

1. Writing careers in IT
2. Do words matter in an age of video?
3. Being a Technical Author/Writer
1
Exercise:
Name some of the best
companies to work for
Two of the best
companies to work for
Do these companies
 employ writers?
Types of writing jobs in
          IT
Technical Writer    Process/Procedures
                    writer
Copywriter
                    Instructional Designer
UI Writer
                    Information Architect
Editor
                    Web Content Manager
Content Developer
Exercise:
Kipling’s questions

        I keep six honest serving
        men
        (They taught me all I
        knew);
        Their names are What
        and Why and When
        And How and Where and
        Who.
Match Kipling’s questions
     to the job roles
                Copywriter
What Why        Content Developer
When How        Information Architect
Where or Who?   UI Writer
                Technical Writer
                Instructional Designer
Copywriter
Copywriter


  Why?
  What?
Content Developer
 Web Content Writer
Content Developer
 Web Content Writer



     Why?
     What?
Information Architect
Information Architect



      Where?
UI Writer
UI Writer


 What?
  How?
Technical Writer
Technical Writer

    How?
    What?
     Where?
     When?
Instructional Designer
Instructional Designer

       What?
       How?
       When?
       Why?
2
Why do they hire
professional writers?
 Do worms matter?
Who visits:
YouTube without words
Who buys from:
Source: Acrolinx
3
What do Technical
Writers/Authors do?
Explain how to use a product

    Using words, mostly
Exercise:
you will write a user guide...
....for one of these
There are five stages

1. Researching the product & audience
2. Planning the project
3. Writing the Table of Contents
4. Writing the topics
5. Review and amend
There are five stages
        We’ll do three of them

1. Researching the product & audience
2. Planning the project
3. Writing the Table of Contents
4. Writing the topics
5. Review and amend
1. Researching the
     product
You talk to the
“Subject Matter Expert”
You use the product
You use images, diagrams
  and/or screenshots
2. Planning
Planning
Planning
         Who is the audience?
What do you want them to be able to do?
          What is the scope?
       What is the level of detail?
        How will it be delivered?
To save time...

 Create a user guide on paper
for teachers in Matthew Arnold,
  that enables them to send
typewritten messages to other
          teachers.
3. Writing the
Table of Contents
Exercise: Create a Table
      of Contents
Tip: Kipling’s questions
           I keep six honest
           serving men
           (They taught me all I
           knew);
           Their names are What
           and Why and When
           And How and Where
           and Who.
So let’s research the
       product
Table of Contents:
How did you get on?
Tip: Use Gerunds
Tip: Use Gerunds


     -ing words
   Opening, Saving
4. Writing the topics
Exercise: Write a topic
Topics you could write

      Loading the paper
     Writing the message
  Making more than one copy
    Sending the message
Tip: Use the crib sheet
Tip: Use the crib sheet


  It explains how to present
different types of information
Tip: The Active Voice
Tip: The Active Voice


    “Open the door”
Tip: The Active Voice


    “Open the door”
Not “The door was opened”
Tip: Commas matter
Review & Reflect

Writing as a career in IT