Cherryleaf “green screen” videos

We’ve been putting together some short length videos that we can use on the Cherryleaf website. These are “quick and dirty”, three to four minute videos, shot behind in front of a green screen.

One explains why technical communication is changing:

Another looks at recruiting a Technical Author:

Each video takes a couple of hours to create, and we hope to add more over time.

Microsoft’s “No more robot speak” in action

 

Our post about how Microsoft is changing its writing style (Microsoft moves away from “robot speak” in its user documentation) generated a lot of interest, so I thought it might be useful to post some examples of it that we’ve spotted.

These examples are from Office 365 Premium Edition.

Continue reading

“Bad information is Marketing’s fault problem. Good information is Tech Comms’ specialty. Let’s do the maths.”

inbound marketing and technical communicationsThe quotation in the title is from Roger Hart’s presentation at last week’s TCUK14 conference. Roger is a product marketing manager who spent a few years as a Technical Author. In his presentation, Collateral damage: do marketing and tech comms have to fight when users get informed?, he explained some of the most powerful marketing content today is high quality user information – especially the content that Technical Authors produce.

Continue reading

Microsoft moves away from “robot speak” in its user documentation

DSC00498One of the highlights from the Technical Communications UK 2014 conference was the keynote presentation from Microsoft’s Doug Kim. Doug is Senior Managing Editor for Office.com, and leads guidelines and best practices for Voice in Office. By Voice, he means the tone of voice and style of English used in the User Interface and user documentation.

Doug Kim at TCUK14

The change in voice is something we explore on our advanced technical writing techniques course, so I was interested to see how Microsoft was addressing this topic. The good news for us is that Microsoft’s approach is consistent with what we advocate on the course (however, we will need to update the course before the next one in December to include some of the topics Doug discussed).

Continue reading

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.

How we record videos for our online training courses

We’re just starting to record the video inserts for a new online training course we’re developing. As I’ll presenting at the TCUK 2014 conference on on this topic, I thought I’d take a few photos in case they come in handy during my TCUK presentation.

We record the presenter actually presenting the slides, as this results in a more natural presentation style. The presenter sees the slides on the laptop, and we use the laptop’s camera for recording the video.

our studio set up

Previously, we’ve recorded to a white background, but for this course, we’re going to be using a green screen. We record the audio using a USB microphone and a digital voice recorder. This means we have two audio recordings of the presentation.

The presenter sees a copy of the slides on the laptop screen, which he can progress through using a remote control. He also sees the script via a teleprompter on a tablet.

What the presenter sees

The green screen (we use chroma-key to remove the background) is giving us more consistent results than having a white background.

It’s a comparatively low budget setup, and it seems to work.

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.

Technical communication as a brand

Flickr image by Ruper GanzerOne of the tea break discussions at the Congility conference I spoke at last month was over the need to improve the awareness of technical communicators and technical communication as a profession.

I suggested the profession would benefit from having (and promoting) a simple positioning statement that explains the profession as if it were a brand. This is something I believe Tekom, the German professional body, did in the early 2000s. Tekom carried out some research in Germany that suggested as many, if not more, people were carrying out a technical communication role as part of another job, and that they were not aware the profession of technical communicator existed. So they aimed some of their marketing efforts at these groups, to make them aware of the profession. They wanted to see if they could bring these people into the Tekom membership.

In fact, I think there should be two statements to improve awareness of the profession:

  1. One saying there are these people called technical communicators who could help your business.
  2. One aimed at people who are writing technical documentation, but don’t realise it is a profession, with a professional body, standards etc. that could help them do it better.

Looking at the STC and ISTC sites, there are some useful simple descriptions of the profession. I’ve used content from these two sites to come up with the following description for the first statement:

“Technical Communicators are professionals who take technical and complex information and make it clear to people who need to understand and use it.

They have skills in providing the right information to the right people, at the right time. They communicate by using technology such as Web pages, Help files or printed content.

Having clear instructions can make all the difference to users of products or staff carrying out tasks. That’s because the need for accurate and accessible content has never been greater.”

We hope to progress this idea a little bit further, and produce something that the ISTC, the professional body for UK technical communicators, and ourselves could use.

Do you think the description we’ve used could be improved? If so, please use the comment box below.