These guides provide step-by-step instructions for solving real-world problems.
These are directions, or recipes that will help you achieve a particular end. How to Create a Web Form; How to Plot a Three-dimensional Data-Set; How to Enable LDAP Authentication.
They are goal-oriented.
Tutorials are completely different from how-to guides and should not be confused
A tutorial is what you tell a beginner to learn.
A how-to guide provides an answer to a question only someone with experience can formulate.
A how-to guide assumes some knowledge and understanding. It is possible to assume that the user knows basic skills and can use basic tools.
Software documentation, unlike tutorials, tends to be well-written. These guides are also easy to write and fun.
How to guides must include a list with steps that must be followed in order to work (just like tutorials). It doesn’t matter if you start from the beginning; just at a reasonable point. While how-to guides need to be reliable, they don’t have to be as repeatable as a tutorial.
Guides must be focused on the practical goals. Any other distractions are unacceptable. Here, as in tutorials detailed explanations are not appropriate.
A how to guide must address a specific problem:
This is how how-to guides differ from tutorials in that the reader can assume they know what should be achieved, but not how. In a tutorial, you determine what the reader needs to know.
A how to guide should not be confusing. They will get in the way. Link to explanations if they are necessary.
A how to guide should be able to show you how to do something differently. The user must also understand how the guide can be used to adapt to a different system or configuration than the one you are assuming. You don’t have to be specific so that the guide doesn’t serve the purpose you intended.
Usability is more important than completeness. How-to guides don’t have to be complete. You can end them wherever you feel is appropriate. You don’t have to include everything just because it is relevant to the topic. An overly detailed how-to guide won’t help users get to their solution quickly.
A good title for a how to document is How to create class-based views . How to create a class-based view or worse Class-based views are not.
Copyright 2021, PDFCache.com. All rights reserved.
Cookie | Duration | Description |
---|---|---|
cookielawinfo-checkbox-analytics | 11 months | This cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Analytics". |
cookielawinfo-checkbox-functional | 11 months | The cookie is set by GDPR cookie consent to record the user consent for the cookies in the category "Functional". |
cookielawinfo-checkbox-necessary | 11 months | This cookie is set by GDPR Cookie Consent plugin. The cookies is used to store the user consent for the cookies in the category "Necessary". |
cookielawinfo-checkbox-others | 11 months | This cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Other. |
cookielawinfo-checkbox-performance | 11 months | This cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Performance". |
viewed_cookie_policy | 11 months | The cookie is set by the GDPR Cookie Consent plugin and is used to store whether or not user has consented to the use of cookies. It does not store any personal data. |