Documentation/Self-study guides

This page explains how to write a self-study guide and is intended for anyone interested in writing this type of documentation.

The purpose of a self-study guide is to help readers learn a subject that's already covered in other documentation. A self-study guide explains what documentation to read, why, and in what order, to learn about the subject of the guide. It also provides context for what's often a set of distinct pages.

Writing a self-study guide means gathering links to materials from other locations, for example wikis and other websites, and then presenting a path to understanding complex concepts through these materials.

Note that a self-study guide should contain almost no new instructions. Instead, refer readers to existing materials and do not duplicate their content. If you realize that you need to write original material to explain an idea, place it in a separate how-to guide or a tutorial.

See the examples at the end of this page to get an idea of how to use this template in practice.

Examples

 * How to run basic Pywikibot scripts (self-study)
 * How to host a bot on Toolforge (self-study)