Documentation/Tutorials
A tutorial provides a learning experience, in which the the learner follows the close guidance of a teacher.
Tutorials should be:
- clear about prerequisites
- ordered
- reproducible
Examples edit
- API:Nearby places viewer
- API:Article ideas generator
- API:Picture of the day viewer
- API:Holidays viewer
- API:Presenting Wikidata knowledge
- API:Page info in search results
- Manual:Pywikibot/PAWS
- Gadget kitchen
- wikidata:Wikidata:Pywikibot - Python 3 Tutorial
- wikitech:Portal:Toolforge/Quickstart
- wikitech:Help:Toolforge/My first Django OAuth tool
- wikitech:Help:Toolforge/My first Flask OAuth tool
- wikitech:Help:Toolforge/My first NodeJS OAuth tool
- wikitech:Help:Toolforge/My first Pywikibot tool
- wikitech:Help:Toolforge/My first Rust tool
- OOUI Basics part 1
- OOUI Basics part 2
- Search Wikipedia articles
- Explore page history
- Reuse media files from Wikimedia Commons
- Wikidata Query Service tutorial
Collections edit
- Category:Tutorials
- Wikimedia tutorials
- wikitech:Category:Tutorials
Tools for creating tutorials edit
Description edit
Tutorials are lessons that take the reader through a series of steps to complete some sort of meaningful project. Tutorials are learning-oriented, and allow the learner to encounter and work with the tools, processes, concepts, vocabulary of the domain in a safe context.[1]
In a tutorial, the tutor is always in charge and knows in advance what will happen. What matters in a tutorial is not what is accomplished, or how well, but what the user will learn through the experience.
Required edit
Introduction edit
The first section under the title should introduce the topic and audience of the page and provide a clear description of what the reader can expect to accomplish by following the guide.
Prerequisites edit
The page should include a "Prerequisites" section that describes the required tools, knowledge, or other prerequisites required to complete the tutorial.
Numbered steps edit
Section headings should be numbered to emphasise that the user is to follow the tutor's guidance closely, should and represent a clear sequence of steps.
Set expectations and verify success edit
A tutorial should provide psychological safety, so that the learner does not expend mental energy trying to understand whether things are going well or not. "When you do x you should notice y" or "Observe that ..." help reassure the learner, and also draw their attention to important signs in their working environment.
Working examples edit
Commands and examples should be tested for accuracy.