Category: Podcast
Last updated on Oct 8, 2020
As you may or may not know… we run what has now become the world’s most downloaded documentation focused podcast!
We have been interviewing the best and brightest minds in the world of technical writing and documentation since December of last year and April… was an interesting month.
We welcomed seven guests onto the show: Allan Duquette, Keith Johnson, Jennifer Lambourne, Tom Johnson, Megan Driscoll, Kavitha Kandappan, and Sindhu Surenthran – we are deeply grateful for the time each of them spent with us to record their episodes.
I have summarised five key insights from these episodes below:
“Stumbling into documentation through education…”
Three out of the five Knowledgebase Ninjas ‘stumbled’ into their career in documentation whilst at college/university:
We asked all of the Knowledgebase Ninjas what important factors they consider when creating their companies documentation, this brought out a couple of interesting conversations about how to better your documentation.
Jennifer shared her single most important factor is putting your users first, you can do this through asking:
Once this has been decided and the content has been created, she highlights the next important factor which is benchmarking and measuring the documentation to make sure the content is actually helping people.
The number #1 most important factor to consider when creating documentation is “the customer themselves”. Megan keeps an eye on where HubSpot is seeing a high volume on customer support tickets and then their team will focus efforts on those areas.
Megan Driscoll of HubSpot said:
“Do not underestimate the impact that documentation has throughout other departments of your business.”
Megan’s team are constantly updating their documentation based on feedback from customer and updates made to the product by internal development teams. Megan’s team also conduct internal research with customer facing teams to understand which areas of their documentation could be improved.
Jennifer shares that the methods they use to measure the ROI on internal and external documentation differ greatly. For example, documents that have been written to detail a proposed technical change may be measured by ensuring the proposals are up to date or accurate.
Regarding external documentation, Monzo are currently undergoing a benchmarking exercise to understand how confident the customer operations team is in their external support documentation. This benchmark will enable Jennifer’s team to test and improve going forward.
However, Kavitha disagrees with this statement by saying that you cannot put a number on how documentation supports a user’s need. A few questions to ask when measuring documentation successes are:
See the documentation resources shared by the Knowledgebase Ninjas in Apri:
ReadMe Checklist – Daniel Beck
Developing Quality Technical Information – IBM
Microsoft Style Guide – Microsoft
And there we are!
Feel free to check out each individual episode here:
Sindhu Surenthran of a Multinational Company
Kavitha Kandappan of AMD
Megan Driscoll of HubSpot
Jennifer Lambourne of Monzo Bank
Keith Johnson of InfoPros
Allan Duquette of Proposify
Thanks for reading!!