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.

Reflections on the TCUK15 conference

I was one of the presenters at last week’s Technical Communication UK 2015 (TCUK) conference. TCUK is the Institute of Scientific and Technical Communicators’ (ISTC’s) annual conference for everyone involved in writing, editing, illustrating, delivering and publishing technical information. It’s an opportunity for Technical Communicators from the UK and mainland Europe to meet up and mingle, learn and present.

auditorium at tcuk 15 conference

Here are my reflections on the event.

Continue reading

The ContentHug interviews

I was asked to take part in the ContentHug series of interviews on technical communication and content strategy.

It was fun and challenging, going through the questions.

ContentHug’s Vinish Garg is interviewing a number of consultants involved in technical communication and content strategy, and asking them essentially the same questions. By reading the interviews, you can see where there are areas of agreement and where there are a variety of opinions. In general, there is a fair bit of consensus. They are worth reading.

Stack Overflow is moving into documentation (get the popcorn)

Stack Overflow, a collaboratively edited question and answer site for programmers, has announced its plans to add documentation to the site:

“Lately we’ve been asking ourselves “what else could we do to improve developers’ lives on the internet?”. Jeff’s original announcement of Stack Overflow said this:

There’s far too much great programming information trapped in forums, buried in online help, or hidden away in books that nobody buys any more. We’d like to unlock all that. Let’s create something that makes it easy to participate, and put it online in a form that is trivially easy to find.

Stack Overflow has made all of that a lot better, but there’s one area that is still hanging around: Documentation. Just like Q&A in 2008, Documentation in 2015 is something every developer needs regularly, and something that by most appearances stopped improving in 1996. We think, together, we can make it a lot better….

…We’re hoping we can improve documentation, not just move it under the stackoverflow.com domain.”

It will be fascinating to see how this project progresses – what issues they encounter, how they tackle these, and if the solutions work.

Continue reading

Our roadmap for technical communication training

We’ve been quieter than normal when it comes posting content to this blog. The reason for that has partly been down to us working on new training modules. We’re now at a point where we can share our current “roadmap” for training course in technical communication.

Earlier in the year, we were involved in a project to develop a Masters course in technical communication. Although that course was postponed, we’ve been continuing the development of some of the training modules, with the view of offering training modules on the management and planning of technical documentation projects.

The roadmap

Our plan is to offer a range of training courses:

  • The fundamentals of technical writing

This is mainly for new technical communicators. This already exists as our online Technical Author/technical writing online training course

  • Advanced technical writing techniques

This is for experienced technical communicators who want to know about the current trends and ideas. This also already exists as our classroom-based Advanced technical writing techniques course.

  • Planning and managing documentation projects

This is the new course we have been developing. It is for documentation and project managers responsible for managing and planning online or paper-based documentation. The course covers project planning, Information Design, estimating, managing the actual project, metrics, establishing standards, governance and maintenance.

We are thinking about offering this as a live course delivered over the internet. We have run a number of courses this way for clients over the summer months, so it is possible to offer training in this way. The alternatives would be to offer it as a public classroom course, held in at our training centre in central London.

  • DITA training

This is for people both new to DITA and already using DITA. This also already exists as our online DITA fundamentals and our classroom-based advanced DITA course. The online course could be included in the planning and managing documentation projects course.

  • Single sourcing training

This course is for people who want to re-use, re-publish and re-purpose more content, and need to understand single sourcing and plan a single sourcing migration project. They need the basic skills in single sourcing and writing content for reuse. This also already exists as our online single sourcing and content reuse training course. This course could also be included in the planning and managing documentation projects course.

  • Embedded Help writing strategies training course

This course helps UX developers and technical communicators better understand how to create and write in an embedded Help environment. This course could also be included in the planning and managing documentation projects course. See Embedded Help writing strategies training course.

  • Content strategy training

This is for people planning and implementing a content strategy project. This can be for a website as well as for technical documentation. This exists as our online Introduction to Content Strategy course.

  • Policies and procedures writing training

This is for organisations needing to train their staff in how to create clear and effective policies and procedures information. We have been running this course as an onsite classroom training course for a while. We plan to also make this course available as a public classroom course in the next few months. See Policies and procedures writing courses – beginner and advanced.

  • Training in authoring tools

Because many of the vendors offer training in the authoring tool themselves, we’re unlikely to focus so much on this area.

Share your thoughts

Are we missing anything? Do let us know.

Ellis will be speaking at MadWorld 2016

MadWorld conference

Cherryleaf’s Ellis Pratt will be speaking again at MadCap Software’s conference on technical communication and content strategy conference. MadWorld 2016 will be held between the 10th and 12th April 2016 at the Hilton San Diego Resort and Spa, in San Diego, California.

Continue reading

New date for our advanced technical writing course

Trends in Technical Communication Course – Advanced Technical Writing TechniquesWe’re moving our public classroom course on Trends in Technical Communication Course – Advanced Technical Writing Techniques from the 18th September to Tuesday 22nd September. There are places available if you’d like to book.

We’ve also run this course a number of times during the summer as an “onsite” course for clients, using WebEx and Lync (soon to be called Skype for Business). Using online meeting technologies like these means we can deliver training to authoring teams throughout the world.

We have been asked if individual delegates overseas could use these platforms to participate in our public, classroom, course. I’m afraid we don’t offer this. The “online meeting” courses involve using special lighting and audio equipment that isn’t available in the training rooms we use for the public courses. Also, it would be very difficult for the trainer to manage two different delivery methods simultaneously.