About Ellis Pratt

Ellis Pratt is Sales and Marketing Director at Cherryleaf. You can follow Ellis on Twitter. Cherryleaf helps you provide technical and user documentation your customers will love - through our content development, recruitment, consultancy and training services. See the main Cherryleaf web site for more details.

We’re looking for someone to take our Technical Author induction online training course, free of charge

We’re looking for someone to take our Technical Author induction online training course, free of charge, in exchange for doing something that will help us develop future versions of the course.

This course was one of the first we developed, and, at that time, we didn’t use formal scripts in the creation process. In the next 18 months, we’re planning to re-record the course videos and revise some (approximately 5-10%) of the content. Having a script for the course will help.

So, in exchange for taking the course for free, we’d like that person to write a transcription for us of what the presenter is saying (which you’ll send to us). The document can be in .txt or Word format. You’ll benefit from having taken this couse, and having taken great notes for yourself as well!

Contact us if you’re interested in doing this.

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

The lost Steve Jobs interview – on successful products

Last night, we watched Steve Jobs: The Lost Interview on Netflix. It’s a lengthly (70 minute) interview from 1995, in which Steve Jobs discussed his recipe for a successful business. The interview was made 19 years ago when Steve Jobs was still running NeXT Computers, and just six months before he rejoined Apple.

Here are some highlights.
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

Location of Technical Authors – new data added to the map

location of technical authors August 2014

The Institute of Technical Communicators has kindly provided us with additional data for our Location of Technical Authors map. They’ve supplied us with an anonymised list of the location of ISTC members. These are indicated by the peach coloured pins on the map.

It confirms the locations where there are shortages of Technical Authors, with the exception of two areas: Birmingham and Glasgow. It also suggests new clusters: one around Colchester and Ipswich, and another around Cardiff.

 

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.