It’s a while since we covered polices and procedures writing, so just a quick post to say Cherryleaf helps companies document their procedures for dealing with, and recovering from, unexpected disasters. It also can include planning for contingencies, including events that might seem highly unlikely.
There isn’t a great deal of research into API documentation, and the factors that make API content good or bad. Here’s some of the papers we’ve found so far:
- How API documentation fails. Research by Uddin and Robillard, McGill University, 2015.
- Creating and Evolving Developer Documentation: Understanding the Decisions of Open Source Contributors, Dagenais and Robillard, 2010.
- How API documentation can be effective and useful (in German). 12 month research project by Prof. Michael Meng et al. Merseburg University of Applied Sciences, Germany, 2016.
Do you know of any others?
At the TCUK 2015 conference, Rachel Johnston mentioned the idea of a content maturity model. We thought we’d take this idea and ask:
Could we develop a model that illustrates a hierarchy of needs for users of technical communication (and in particular, User Assistance)?
A model of what?
We suggest calling this model a technical communication user’s hierarchy of needs. This is because we’re considering the different points where a user interacts with technical communication content, the information they need, and value it gives to them.
It takes a similar approach to the content maturity model Rachel suggested (shown in the photo below), with the least mature organisations providing just the legal minimum, and most mature content systems contributing to branding and evangelism.
A user’s hierarchy of needs also enables us to compare this model to similar models from content marketing and product design. For example, the categories in our model’s hierarchy roughly correspond to Peter Morville’s “User Experience honeycomb”, as well as the key elements in product design.
Adrian Baniak has written an article (3 Ways to Engage with Today’s Empowered Consumer) about how brands can “cut through the clutter” and communicate with their customers and prospect. He states one of the key ways to do this is “Write Your Own Tale, Or Someone Else Will Do It First”.
This mantra was originally made by Lisa Shalett, a partner at Goldman Sachs, and the global head of brand marketing and digital strategy. Continue reading
At some stage or another, a technical communicator is likely to have seen this image from Kathy Sierra:
In conjunction with The Society for Technical Communication, we’ll be presenting the webinar Planning User Documentation When You Are a Startup Business on Tuesday, 19th February.
In this presentation, we’ll look at how to plan a user documentation project when you’re working for a startup technology company. Working in this environment gives you the opportunity to work “from a clean sheet,” but it also has its own challenges of working in a dynamic and rapidly changing environment.
Through its Listener Scheme in prisons, Samaritans provides emotional support to prisoners who are struggling to cope, are self harming or are feeling suicidal.
Guidance for Samaritans volunteers that run and support Listener schemes was contained in a hard copy manual (the Guide to Prisons) which was cumbersome to update, difficult to navigate and not in a format that made it easy to share with prison staff. As a result, over the years, volunteers referred to it less and less frequently meaning that consistency in delivery of the Listener scheme across the prison estate was being compromised.
Cherryleaf were tasked with converting the manual to a fully searchable, easy to use, online resource that would link to other relevant information on the Samaritans intranet and could also be made available on the Prison Service intranet. The new online Guide to the Listener scheme means that both Samaritans volunteers and prison staff have access to the same, up to date, comprehensive set of guidelines and information.
Maria Foster, Samaritans’ Prison Support Officer said:
“For Samaritans volunteers, having the information available on the intranet rather than in a manual in their branches, means they can find out what they need to know at any time; the search facility and page style ensures that information can be located and read quickly and easily.
For prison staff, this is the first time they will be able to see all of the Samaritans guidelines for running the Listener scheme; this will help to further develop their understanding of the scheme and will support them in facilitating the operation of the scheme in their prison.
Samaritans is delighted with the result of the project;
Cherryleaf understood the brief and very quickly got to grips with the subject matter, turning a cumbersome manual into a streamlined user friendly resource.”
The Samaritans provides confidential emotional support for people who are experiencing feelings of distress, despair or suicidal thoughts. You can talk to them, any time, on 08457 909090 (UK), 1850 60 90 90 (Republic of Ireland) or firstname.lastname@example.org .
In Data Quality Pro Journal, Dylan Jones interviews Ellis Pratt, Director at Cherryleaf, about how to improve Healthcare data quality through policy and procedure management. According to Dylan,
“One of the single most common root-causes of poor information quality is outdated documentation and a lack of governance in the way policies and procedures are managed. Nowhere is this more critical than in the healthcare sector.”
Ellis shares a range of practical techniques and methods to help improve policy and procedure documentation within the healthcare sector.