Category Archives: STC

Interviewed by STC Australia Chapter

The Australia chapter of the Society for Technical Communication has published an interview with me! It’s about building your personal brand, technical writing, and whether or not you’re emergent. ;) Thanks very much to Tim Hildred for inviting me to be interviewed. It’s an honour. And thanks to Tim also for compiling such a great list of questions.

Invitation to a webinar about doc sprints tomorrow

Along with the Society for Technical Communication (STC) I’ll be presenting a webinar tomorrow, about doc sprints. It would be great if you can join us!

The webinar is titled Doc Sprints: The Ultimate in Collaborative Document Development. It’s full of information about planning and running a doc sprint, and how doc sprints are useful in developing the documentation our readers need.

As well as information gleaned when running doc sprints at Atlassian, I’ve included stories and tips from doc sprinters around the world: Anne Gentle, Swapnil Ogale, Ellis Pratt, Katya Stepalina, Andreas Spall, Jay Meissner, and Peter Lubbers. The stories are what make a good doc sprint awesome.

How to sign up for the webinar

Dates, times, and registration details are on the STC site: Doc Sprints: The Ultimate in Collaborative Doc Development.

Invitation to a webinar about doc sprints tomorrow

Oh, just so you know, it will be 6am here in Sydney. I’ll watch the sun come up while presenting the session. :)

STC Summit 2013 wrapup #stc13

Today is the last day of  STC Summit 2013, the annual conference of the Society for Technical Communication. All the sessions are finished, and I’m wrapping up my blogging before getting on a plane. You’ll find my posts under the tag stc13 on this blog.

Kudos and a big vote of thanks to Paul Mueller, Chris Hester and the STC conference committee for organising such a great event. From my point of view, the organisation was flawless. I had fun, learned a lot, met great people, and spoke my piece to my satisfaction too. All of those are thanks to the hard work of the organisers.

There were 80+ education sessions, spread over 7 tracks, as well as various workshops, demos, trade expositions, training sessions and social events. I’ve blogged about the sessions I attended. Please take the posting dates with a pinch of salt. My WordPress site is set to Australian time.

Because there were many sessions running concurrently, it’s not possible to attend them all. I also attended a progression (a sequence of short talks within the space of an hour) where the pace was too fast for me to take notes.

More sources of information

Kai Weber has published some posts about the conference. Knowing him, he’ll come up with more once he’s made the long trip back to Germany. See posts tagged “stc13″ on Kai’s blog.

Twitter is very active at the moment. You can catch the tweets on the #stc hash tag. That feed will fade in a few days, when the Twitter search API times the entries out.

You’ll find a full list of sessions, along with information about the speakers and related links for each session, at the STC Summit 2013 site on Lanyrd.com.

I’m sure the STC will publish a summary and more links soon. And there are other bloggers around too. Stay tuned!

For a touch of light relief: A report from the intrepid band of STC ghost busters.

Pictures

At the opening session and keynote presentation on Sunday. The stage before the action starts:

STC Summit 2013 wrapup

The audience getting ready for the big event:

STC Summit 2013 wrapup

The keynote speaker was David Pogue, technology columnist for the New York Times and creator of the Missing Manuals series. At this Summit, David was awarded honorary membership of the STC. Here’s Alan Houser, outgoing STC president, with David Pogue:

STC Summit 2013 wrapup

David in full swing:

STC Summit 2013 wrapup

Intrepid ghost hunters on the Atlanta Ghost Tour:

STC Summit 2013 wrapup

Nope, not really convinced there’s a ghost around here, but we’re having fun anyway:

STC Summit 2013 wrapup

Thanks again everyone at stc13!

Data visualisation at STC Summit 2013

This week I’m attending STC Summit 2013, the annual conference of the Society for Technical Communication. I’ll blog about the sessions I attend, and give you some links to other news I hear about too. You’ll find my posts under the tag stc13 on this blog.

This is the last session of the conference! It’s called Data Visualization: Seeing through the Numbers, presented by Phylise Banner. Phylise will also present some material from Rob Mitchell.

The most important map in the world

Phylise showed us a map of the Soho area of London. For the work we do as technical communicators, this is the most important map in the world.

John Snow, who lived in England in the 1800s. During the great cholera outbreak, he plotted the homes of the people who were dying. From this map, he was able to trace the source of the disease to the water source. The notion of relational data telling a story. As a result, the city owners took the handle off the Broad Street pump, and the outbreak stopped.

Ten questions we need to ask

  1. What story are you trying to tell?
  2. What actions do you expect people to take? Are you creating visualisations for a decision maker, an explorer, or whatever, and what actions will they take based on your data?
  3. What route will you take? Explore the data further. There are places where you can get data and explore it. Until you see what is there, you don’t know what you’re looking for.
  4. What is the difference between qualitative and quantitative data? You need to know the difference. Quantitative is numbers and values. Qualitative is descriptive data. Some data is both.
  5. Where does the data come from and what are the sources? Site your sources, and link to it if you want. Make sure it’s real, secure and correct. This may not be an easy task. Think about where else you can get it from.
  6. What tools are available? There are some really interesting and good tools available:
    • ManyEyes, from IBM. This is an online open tool, one of the best out there. Explore the data sets available here, as well as the visualisations. Be aware, if you put your data up here it will be visible to the world. Playing with this tool is a great way of learning. Read the section on data format and style.
    • Tableau Public is a free version of Tableau. A great free tool.
  7. What are the best practices? Best practices for working with data are different from those for working with visualisations. It’s not about being a mathematician or statistician, but it is about getting to know the field.
    • Read Stephen Few and Tufte.
    • Avoid pie charts. (This has come up in all three of the data visualisation sessions I’ve attended at this conference.)
  8. What to do with the data?
    • As an exercise, try comparing and contrasting the nutrition facts from difference restaurants. Phylise showed us three PDF files from various restaurants. How can you process a PDF file? You could try an OCR. But the first step is to decide the story you want to tell, then extract the relevant data. Type it into Excel so you can work with it.
    • Phylise showed us an Excel file where a single column contained 1 to 3 values, and occasionally text. This is the kind of mess you often get. So, you’ll need to clean the data before you can use it. This often takes up a large part of the task.
    • Learn regular expressions and Excel’s find/replace syntax, including wild cards. See Regular-Expressions.info.
    • Code dichotomous variables to 1 and 0.
    • Pay attention to case. In qualitative data, a difference in case is a different variable.
    • Watch for invisible baddies! For example, spaces at the beginning and end of column. This expression is your friend: ltrim(rtrim(Field))
    • Watch out for ampersands. Use the word “and” instead.
    • Remember that 1.0 is not the same as 1. Check your character types,and watch your floats versus integers. When rounding, make sure you have a standard policy.
    • Watch for outliers – data points that don’t fit in with the data. You can decide to take these out, if they’re not important to your data. But think about what it means. The outlier may be what tells your story.
    • Beware of the acceptable leading zero. For example, there are zip codes that begin with zero. Make sure the data type is text, if relevant.
    • If you’re using comma-separated values, use quotes. Otherwise you’ll run into trouble when the data itself contains commas.
    • Write macros to clean your data, if you get the same data regularly. This is where technical communicators have the skill sets required.
    • Figure out what the data is saying. For example, in qualitative data, you may need to know how many times certain words come up.
    • Decide on the best way of representing the data. For example, to create a word cloud, you may need a document containing all the words, repeated the relevant number of times. Phylise showed us a case where it took her more than a week to clean the data, then 30 seconds to generate the word cloud.
  9. What is the context? What is around the data, and what do you want to say in the specific environment?
  10. What comes next? What other stories can you tell, and what new data can come from the data you have. You’ll never know this until you know the context of the data you have.

Some data to play with

Phylise shows us a list of data sources. They will be available on SlideShare. Here are a few I had time to note down:

Tools

Some I noted:

In summary

There’s data behind every visualisation. Unless you get to know the data, you’re just creating another picture. You can become incredibly valuable if you go for what it means to work with the data.

ManyEyes is a wonderful way to start.

A marketing communications career at STC Summit 2013

This week I’m attending STC Summit 2013, the annual conference of the Society for Technical Communication. I’ll blog about the sessions I attend, and give you some links to other news I hear about too. You’ll find my posts under the tag stc13 on this blog.

I’m attending a session titled A Marketing Communications Career: Making the Transition. The presenters are Barbara Giammona, Vici Koster-Lenhardt, Rich Maggiani, and Eric Koup.

Summary of how marketing looks from the tech comm side

How does a technical writer move into marketing? Someone comes and asks you to write content for the website, or a proposal, or a document to solve a crisis.

Some technical writers aren’t comfortable with writing marketing content. We’re comfortable writing something we can touch and test.

Another way to come into marketing: Perhaps your manager offers to change your title to be tech writer / marketing communication. Or you move fully into marketing.

What’s different about the role: The messaging, advertising, understanding the corporate and internal communications messaging.

For the rest of the session, the panel answered a number of pre-set questions. These are my notes from the resulting discussions. I haven’t tried to put people’s names next to each reply, but rather just summarised the whole picture.

Key differences in attitude

Typically, technical writers focus on details. They may struggle with structuring and presenting something from a different strategic point of view. The ability to evaluate what’s important is key.

The skills of a tech writer can come into play, being able to simplify the language into just what you need.

Is marketing lying? To many of us, it does seem so. So we should think about the transition path, if we want to move into marketing. Choose what’s closest to what we want to do.

The target market changes from users to buyers, and the content therefore becomes much more strategical. As soon as you start on the marketing path, you become more visible.

The requirements from management are not as clear-cut in marketing as in technical communication. You need to know the wider goals of the organisation. This requires less time in front of the screen and more time in trying to understand the aim. This takes collaboration.

Personality types

Looking at the Myers Briggs personality types, what is the difference between a tech writer and a marketing communicator?

A marketing person will have more contact with humans. Take this into account, especially if you are more of an introvert.

A marketing person tends to be intuitive, and are more of a feeling person than a thinking person. Perception is a strong gift for marketing. If you’re too rigid, the transition would be difficult.

Even if you’re a strong introvert, you can still play the extrovert, and make sure there are times in between when you can recharge. If you’re an extrovert, you may want to go into management.

Education

How would you go about taking the next step to getting into marketing?

You could be extreme, go back to school and get a degree, such as an MBA of marketing. Alternatively, do some certificate courses. Analyse your existing skills and see what more you need.

Volunteer for any project you can. If someone needs a newsletter, be the person who writes it.Newsletters may give you the opportunity to talk to higher management, and network with people you wouldn’t normally meet.

Look for volunteering opportunities outside the workplace too.

Set a clear goal of where you want your career to go. Then fill in the needs as you move along the path. Remember that your route to the goal may change along the way. Take it step by step.

Pros and cons, perks and challenges

Marketing is “way more fun” and “way cooler”!

Planning parties, making posters, organisational, project management… you’ll use all your skills. You’ll also work on more concurrent projects than you would as a tech writer. Emergencies happen, so you need to be fluid and juggle changes and concurrent projects.

It’s harder to plan vacation. Your work cycles are not based on the product release cycles.

You feel more part of the strategic plans of the company. You leap into a different track. You have a higher visibility to management. So you need to be sure you know what you’re doing.

Perks include travel. And you’ll make more money.

And you still get to write!

On the other hand, if you’re into tools, you’ll find that marketing is not about tools. It’s about communication rather than tools. Often the marketer asks someone else to do the design.

How do you break in?

The panel recommends the International Association of Business Communicators. They have the same kind of resources as STC, in terms of publications, knowledge banks, and job listings. They’re also very extrovert and welcoming.

Indeed.com is a job aggregator that will give you a feed of jobs available.

An organisation called Melcrum focuses on the employee and internal communication, useful if you’re in internal marketing.

Networking inside your own company will find you opportunities. Network outside your company too, as you never know where the opportunity will come from. Talk to your neighbour, volunteer organisations, and so on.

Do some volunteering inside your organisation. Managers don’t have time, and hate, to do the marketing for the projects they’re working on. Network with your sales force (customer care). Ask them if they need help, say “I can write that”. Take people to lunch. There is tons of marketing communication coming from HR. Find out who is writing the newsletter in your company. There may be a great opportunity to improve it.

Questions from the floor

These are the notes I took during the question-and-answer part of this session:

  • When talking to designers and other people who produce the deliverables, have a vision of what you want. You don’t need to know how to use the tools. You just need to know what you want.
  • What about recent college graduates looking to break into marketing communications? College doesn’t prepare you for some realities in the working world. One is the iterative nature – you do things again and again. The review process, and the number of stakeholders who have a say on your work, can also be a surprise. It’s very collaborative. Every day at work is a group project. If you’re just coming out of college, find a place that offers an internship. Many places offer great interships, and there’s a variety of them.

Thanks to the panel

This was a good insight into what marketers do, and some different types of marketing roles. Thanks Vici, Barbara, Rich and Eric.

Follow

Get every new post delivered to your Inbox.

Join 1,388 other followers

%d bloggers like this: