4 Best Practices to Involve SMEs in Product Document Creation
While there is no shortage of guidance on how organizations can engage employees in creating marketing content – such as blogs, social media posts, LinkedIn updates, and so on – there is a surprising lack of practical advice on how to engage Subject Matter Experts (SMEs) in the product documentation process.
As a result, many technical writers spend an inordinate amount of time chasing down SMEs trying to set up interviews, having follow-up conversations, verifying facts, resolving inconsistencies, and the list goes on. And for their part, many SMEs don’t fully understand the process, and as such find the experience tedious, inefficient and sometimes even redundant -- which is why they avoid and resist participating.
Obviously, product documentation will continue to remain a core asset that connects organizations and brands to customers; and not just those who have made a purchase or are using a product, but also by those who are doing their pre-sales research. As such, resolving this lingering disconnect with SMEs has to be addressed; because it won’t somehow solve itself in time. On the contrary, it will get worse!
Fortunately for technical writers, addressing the gap and efficiently, effectively and (dare we say it?) enjoyably involving SMEs in product documentation creation is both possible and practical. These 4 best practices go a long way towards making this happen:
As noted above, many SMEs don’t fully understand the product document creation process (even if they think they do!). As far as they’re concerned, the defining characteristic of the process is that every now and then, a technical writer sends too many emails and voicemails about scheduling an interview. Technical writers can end this misunderstanding by taking the initiative, and educating SMEs on the process – such as by creating an on-demand webinar that can be uploaded to the company intranet, creating a PDF or web page, and so on.The idea here isn’t to overload SMEs with training material that, frankly, they won’t watch or read. Rather, it’s to equip them with targeted, efficient information that helps them understand their role in the process, and – even more importantly – why it’s in their interest to actively participate.
Most technical writers are skilled interviewers, typically because they’ve done so many of them over the years. However, even the most seasoned veterans – and especially skilled or emerging professionals – could benefit from brushing-up on their interview techniques. There are plenty of books, videos, workshops, websites (like this one) and specialized coaches who can help with various aspects, including:
Some technical writers brace for impact when they come across the phrase “agile documentation”, because it’s often a precursor to what turns into a chaotic free-for-all – kind of like what an airport runway would be like without the air traffic control tower. However, technical writers who strive to overcome their well-earned aversion to agile documentation will discover that there are core principles of this approach that they can and should leverage – because it makes their jobs much easier and more efficient, and just as importantly, helps bring SMEs into the process. Based on insights suggested by Agilemodelinh.com, technical writers can borrow the following from the agile documentation playbook -- regardless of whether they are working in software development or any other space:
An intelligent product documentation platform allows technical writers to bring both SMEs and customers into the product documentation creation process. For example:
To be frank and fair: there is no magic wand that will instantly make it blissful for technical writers to engage SMEs in the product documentation creation process. However, it doesn’t need to be – and frankly can’t afford to be – a tedious, uphill climb; or an all-out struggle.
Implementing these 4 best practices will go a long way to making the process work MUCH better for everyone, which is not just valuable to technical writers and SMEs. In the bigger picture, it’s key for organizational success and long-term survival.