Audience Analysis

before writing any document, you need to know who you are writing it for your readers may be experts in the field or they may be complete novices; without proper audience analysis, documents risk being unclear, misinterpreted or ineffective audience analysis should include the following information about the users job role experience level usage context learning style and preferred level of detail tasks they want to accomplish challenges they face creating personas based on the user information collected as explained in audience analysis , you can segment your audience into groups and create user personas fictional representations of typical users, based on real data and common characteristics the personas can then inform your documentation strategy for example, you may need a very user friendly getting started section for novice users coupled with a detailed api reference for developers who will implement an integration for more details about creating personas for documentation, see this article on uxmatters even if you don't create written, detailed personas, it is still useful to have a few basic types of audience in mind when creating the documentation for example, a simple split could be between functional documentation (aimed at the end users of an application) and technical documentation (aimed at the it technicians supporting the end users) gathering audience insights to understand what your audience needs, you can collect information directly or indirectly direct user interaction directly ask users about their background, preferences, knowledge levels, and expectations user feedback analyze bug reports and use feedback tools and analytics to track user reactions and assess content effectiveness collaboration with subject matter experts gain knowledge from product managers or customer success representatives who have constant interaction with the end users direct user interaction surveys and interviews the best way to get information about user preferences is to ask them directly, either in writing or in person an in person or zoom interview gives better opportunities for asking follow up questions, but it's also more time consuming for both the interviewer and the interviewee, so a good balance is essential to optimize resources, you can send a survey to your entire user base, then select a representative sample to talk to directly the following table offers some suggestions for questions you can ask in a survey the following table offers some suggestions for questions you can ask in a survey category questions general user information what is your job role or background? how frequently do you use this documentation? what is your level of expertise with this topic? what is your learning style? usefulness & effectiveness did the documentation help you accomplish your task? did you find the information easy to understand? is the information technically accurate and up to date? if not, could you point out which areas need work? do you prefer more detailed technical explanations or high level overviews? were the examples or visuals sufficient? findability how do you locate the information you need? do you use the search engine, the chatbot, the navigation pane? is the organization of the content intuitive? how long did it take you to find the information you needed? accessibility & readability did you experience any difficulties with font size, contrast or layout? would you prefer more visual aids such as screenshots, flowcharts or tables? is the document easy to read on different devices (desktop, mobile, tablet)? do you use a screen reader or other assistive technology to access documentation? if so, does the documentation support it well? usability testing generally speaking, usability testing for documentation implies asking users to accomplish a task with the help of documentation you can use a more general approach by asking people to use the documentation as they normally would or you can run a more detailed test by having them focus only on the table of contents or the search function by observing users interacting directly with the documentation, you can evaluate the clarity of the content identify usability issues understand how users search for information assess readability for more information about usability testing, see this article on the nielsen norman website user feedback user feedback can highlight documentation gaps and usability issues and can help drive prioritization you can gather feedback either directly, by embedding feedback mechanisms on the documentation pages, or indirectly, by analyzing support cases and analytics embedded feedback forms feedback tools in documentation can range from the simple to the complex a mailto link that sends an email to the documentation team thumbs up/down or star ratings that indicate if an article was useful or not feedback forms that encourage users to leave written feedback the usefulness of such features is directly tied to the management strategy behind them best practices include assign responsibility for reviewing the data and tracking patterns store the feedback in a database (even something simple, like an excel file) filter out non documentation related reports use structured feedback forms to capture specific issues rather than vague reactions implement a strategy for communicating the results of the feedback back to the end users documentation teams often jump to implementing feedback mechanisms with unrealistic expectations the reality is that the vast majority of feedback will be either too vague or not really about the documentation make sure to weigh the pros and cons ; if the cost of implementing and managing the feedback form is too large, maybe it's better to use other ways of hearing from your users support team insights if a company has a customer support or customer success team, there is probably a lot of data available that can be used in audience analysis support inquiries can help technical writers to analytics analytics tools, such as google analytics, can be easily implemented in online documentation systems once you have enough data, you can analyze page views to see which sections of the documentation are most accessed you can then prioritize these pages when it comes to improvement initiatives track time spent on a page to understand how users engage with the content, highlighting areas that might be confusing or require more in depth explanations monitor user search queries to see when they don't find the information they need, which can help you make a list of topics that need to be added review drop off points to analyze where users leave the documentation, suggesting areas where the content or navigation might need simplification or clearer instructions collaboration with subject matter experts subject matter experts, especially ones who have direct client interaction such as product managers, can serve as a good source of guidance for documentation customer facing smes can help in audience analysis by clarifying user roles, needs and skill levels helping writers understanding real world use cases next step once you have decided on your user personas, analyzed their requirements and got feedback from the users, you are ready to move on to the next step research docid\ klp8ek1u7snfz66loecpi , where you learn about the topic you are documenting