Technical Writing Tips: How to Make Your Expert Accessible
Technical writing is a lot like business writing.
The two styles of writing overlap so much that any business writer can employ technical writing tactics to their work, and vice versa.
Ultimately, both focus on the audience and what they will need to get out of the document. And when it comes to writing jobs, you serve as the medium between the expert and the audience.
These authorities in their field of knowledge, also known as subject matter experts (SMEs) could include engineers, project managers, technicians, or simply any colleague who’s experienced in the topic.
Your mission as a technical/business writer is to take the SME’s language and ensure it can be digested by your audience. In order to translate the information, you must first collect it from the expert. It’s a process that often involves educating yourself and interviewing the expert(s).
Familiarizing Yourself
If you have the opportunity, it is always a good idea to integrate yourself into the project or research.
Reading existing documentation on the topic and attending meetings will give you a strong head start to developing your work. Additionally, making yourself a member of the team gives you a better grasp of the time frame and most important aspects of the project.
A defined schedule with milestones will help manage time for each task and account for any inevitable setbacks or delays.
Once you’re familiarized with the task, you can commence the interview process. This is likely to last the duration of the project.
Constructing the Interview
Interviews should be personalized for the goal of the interview and the convenience of the expert. They’re often iterative throughout the entire process and can include one-on-one physical interviews, email questionnaires, phone conversations, or even surveys, if you’re trying to reach many experts.
Forming a game plan for your information gathering allows you to lay out a set of expectations for the interviewees.
With your first inquiries, you should establish the parameters for the target document, whether it’s an article, memo, grant proposal, instruction manual, or research report. Some helpful questions to ask the expert include:
- Who is the audience? What prior experience/education do you expect from the target readers?
- What sort of background knowledge is required for you, the technical writer? Are there any secondary resources that the expert thinks would be a good place for other data?
- What is the underlying purpose of the document? Is the goal primarily to educate the readers or are you simply consolidating the information in a more-digestible form?
- How should the information be constructed (i.e. what medium and style)? Will the documentation span multiple forms of media? Will the form change for different audiences? Are there already templates or standards for this type of work in the company?
Performing the Interview
Once you have these details confirmed, you can perform the bulk of the interview process: collecting expert information about the project. Being an active listener here is key, as the expert may not communicate in a very organized manner – the reason they need a technical writer in the first place!
Utilize different tactics to get the expert passionate about the subject so the interview process isn’t a burden, perhaps learning a bit about the interviewees and their personal stake in the project. Making the expert realize that you are part of the team and you’re both working toward the same goal will considerably smooth out any interaction.
Ask the expert to walk you through their interpretation of the project or system and note the aspects that he or she considers the cornerstones.
Take good notes throughout the interview and record the conversation, if possible.
Finally, ask your questions. This is a good opportunity to place yourself in the shoes of the audience.
Subscribe to Beyond Bylines to get media trends, journalist interviews, blogger profiles, and more sent right to your inbox.
Thomas Nicholson is a Customer Content Specialist with PR Newswire and science aficionado with a love for all things nerdy.
1 Response
[…] Well-Preserved Fossil Is the Earliest Bird of Its Kind and more -> By Thomas Nicholson: Technical Writing: How to Make Your Subject Matter Expert Accessible By Joshua Benton: It’s time to apply for an Abrams Nieman Fellowship […]