- Technical documents often have to be translated: products that are traded internationally have to come with manuals that are easily understandable. By setting the technical-translation process up well directly after the technical writing, you can ensure the quality of the technical translations, improve the UX and cut translation costs.
- Oct 11, 2017 User manuals describing device structure and components must do this in the most comprehensible way. And this is a diagram, not a list. Compared to just listing all parts of the system one by one, the structure diagram depicts not only components but also interconnections between them and the type of these connections (as different line styles.
This is where you get to the meat of your video. Make sure it lives up to your hook. Many make the mistake of destroying their video after a great buildup. The CTA: This is the final part of your video. If your hook and patty were good, many viewers will reach the CTA part. This is where you lead them to take some action. Learn how to do anything with wikiHow, the world's most popular how-to website. Easy, step-by-step, illustrated instructions for everything. 7 Tips for Writing an Effective Instruction Manual. Make it easy to understand: Lists are a great way to outline steps for doing something because they can help people move item.
In your day-to-day work, you might find that there are times when you need to provide a client with documentation that walks them through a process or teaches them how to do something they may be unfamiliar with.
I’ve mentioned before that I view writing skills as vitally important for everyone, in every business, and this is a prime example of why being able to write effectively is so important. If you can’t get the steps and details down on paper in an easy to understand and intuitive way, you will probably spend a great amount of time and frustration handling support requests and fixing things done incorrectly.
Here are seven tips to help you create a comprehensive yet coherent instruction manual.
- Get out of your own head: When you begin to prepare instructions for processes you know inside and out, you will need to consciously take a step back and approach the material from a new angle. Start at square one by assuming the audience will have zero knowledge of the subject matter.
- Know the objective: Make sure you know exactly what your manual needs to cover in order to avoid information overload or confusion that can come from too many details. This is especially important when the process is complex or has a lot of different parts.
- Outline it first: Before jumping in and creating steps, create a high-level outline of what the document will cover, including main and subsections. This will help you make sure your process makes sense and that each section of the manual is consistently structured.
- Make it easy to understand: Lists are a great way to outline steps for doing something because they can help people move item by item in the way you intend. It’s also a good idea to use a table of contents and make your document searchable, if possible, to further support your step-by-step approach.
- Be brief: It’s tempting to want to explain everything in fine detail since it’s material you know so well, but stick with only what the recipient needs to know. Focus on using only as many words as necessary to get your point across.
- Use visual aids: Screenshots, diagrams and even videos are a great way to beef up your manual and make it easier to understand. Keep the formatting of these supporting materials consistent and to the point to avoid overwhelming the reader.
- Give it a test drive: Or better yet, have someone else who has never seen the material before run through the instructions. Take their feedback and use it to fine tune your manual.
Keep in mind that you may need to review and update the manual periodically, especially if it’s something that focuses on a third-party application or other system you do not control. Plus, with some material, it may also make sense to offer the client a hands-on walk through to ensure your instructions accomplish what they need to accomplish. And keep in mind that learning styles vary, so one client may be able to run with the same instructions that confuse a different client. Being flexible in your format and delivery can help make sure the instructions work for the recipient.
How To Make A User Manual Interesting Person
Do you ever provide clients with written instructions? What advice do you have?
How To Make A Manual
Image credit: svilen001