Our process for creating elearning videos

I will be talking at the Technical Communications UK 2014 conference (TCUK14) next month about creating videos for technical communication and elearning videos.

elearning video screen captureIt covers how to embed video in a course. The delegates see, in each recorded module, a video of the trainer on the right of the screen, with the slides, application walkthroughs or images on the left of the screen.

This format is more engaging for delegates than a disembodied voice talking over a slide or image.

Continue reading

Writing documentation for the games industry

Flickr Creative Commons image Marco Verch

Last week, I visited Gamescom in Cologne. Gamescom is the largest exhibition and trade fair for computer games in Europe, with over 335,000 people attending this five day event. We visited for social rather than business purposes, but it led me to reflect on the work we and others have done in writing documentation for the games industry.

Continue reading

Is it ok for technical communicators to experiment on users?

Experiment sign Flickr CC image by jurvetsonBBC News is reporting the OKCupid Website has revealed that it experimented on its users. It decided to reveal the tests after the discovery that Facebook had been manipulating the feeds of its users.

It’s possible for anyone to run experiments on web pages, including technical communicators. You can display one page for 50% of your audience and a different page for the other 50%. Organisations carry out these tests to see if there is any change in user behaviour as a result of making a change to the site.

According to Christian Rudder of OKCupid:

“It’s not like people have been building these things for very long, or you can go look up a blueprint or something. Most ideas are bad. Even good ideas could be better. Experiments are how you sort all this out.”

So is it ok for Technical Authors to experiment on users? If it results in the creation of better, more effective, Web pages would you, as a user, object? Clearly, most of us would object to a website manipulating us or causing potential harm – could that ever apply to the type of experimentation a Technical Author might carry out?

Technical communication as a brand – The CEO and the technical communicator

The CEO and the technical communicator ebookSince I wrote the post on Technical communication as a brand, we’ve been working on an idea we had for promoting the profession. The end result is another story, another free graphic novel you can download, called The CEO and the technical communicator.

It’s published under a Creative Commons licence, so anyone can forward it on, as long as they don’t modify it or sell it.

There’s a lot of factual evidence about the value of technical communicators to an organisation (such as the ROI calculators on our website), so we thought we’d see if we could appeal to the heart as well as the head by using a story-based approach.

Technical communication comes in many forms, so there were some challenges in coming up with something that was representative of the whole profession. Partly to get around this, the document shows people’s reactions to the content created, rather than showing the content itself. It also uses the word “content’ as a catch-all for document, manual, book, Help file, Web page, illustration, and so on.

We’ve also developed an ISTC-branded version that the Institute for Technical Communicators could use itself to promote the profession. We’ve sent it to to the ISTC Council for their consideration and comments. The document might be modified if they ask for any changes to be made; for example, we’re wondering if there should be greater emphasis on the writing aspect of the role.

You can download the Cherryleaf version from our website. Let us know what you think, using the comments below or by email.

The “Word Crimes” song – does grammar matter?

Wierd Weird Al” Yankovic’s song about English grammar is actually quite good, and it will appeal to many Technical Authors.

It’s important that someone’s message is communicated clearly, and grammar can help achieve that goal. However, the English language is always evolving. Rules change over time, and people should never be too pedantic.

What do you think?

Ted Nelson on the future of text

Mike Atherton, Lead Instructor at General Assembly London, tweeted a link to a 2011interview with Ted Nelson on the future of text, document abstraction and transclusion.

Ted Nelson is one of the pioneers of information technology. He has been credited as being the first person to use the words hypertext and hypermedia (although he denies this), transclusion and virtuality.

Ted Nelson on the Future Of Text, Milde Norway, October 2011 from Frode Hegland on Vimeo.

It’s an interesting description of how content should be independent of format and media, so it can be portable, re-usable and presented in ways that best suit a reader’s needs.

Our Webinar in August will be: From Technical Communication to Content Strategy

MadCap Software has asked me to present, as a webinar, one of my conference presentations from the  MadWorld 2014 conference – Bust a Move: From Technical Communication to Content Strategy.

In this webinar, we’ll look at how technical communicators can get more involved in corporate content strategy. We’ll look at why they might want to do that, the differences between technical communication and content strategy, as well as looking at how they might re-position themselves. We’ll also look at what tools and skills technical communicators can bring across from the technical communications field.

It was a popular session at the conference, standing room only in fact, with 20 minutes of questions from the audience at the end.

This webinar will be held on the 12th August at 4.00pm BST (8:00 am Pacific Time), and it’s a free event.

I’m afraid there was some confusion over which presentation from MadWorld 2014 we would be repeating, and I mistakenly stated the webinar would be on metrics. That was my mistake. We’ve also had to move the webinar from its original date on the 13th August to the 12th August. Sorry for any confusion caused by these changes.

Ellis