# [Tool or role] training manual

> Replace every text in [brackets]. `# Module …` starts a module and `## Task …` a task. The title and Reference are also level `#`, and About this manual, Glossary, Who to ask and Change log level `##`: they are not modules or tasks. One file per module works in a wiki or a git repository.

## About this manual

| Field | Entry |
| --- | --- |
| Who it is for | [Role, and what they already know] |
| Before you start | [Accounts and roles needed, access to the test environment, test data] |
| How to use it | [Work through the modules in order. Do each task on test data, then do the check without the manual open.] |
| Owner | [One name and team] |
| Version and next review | [1.0, date. Review when the tool changes its screens] |

# Module 1: [What the trainee learns, as a topic]

| Field | Entry |
| --- | --- |
| Objective | [After this module the trainee can … One sentence, a verb you can watch] |
| Tasks | [1.1 …, 1.2 …, 1.3 …] |
| Time | [Minutes for the tasks plus the check] |

## Task 1.1: [Verb + object, the way people ask for it]

- **When:** [The event that starts it]
- **Work instruction:** [Title of the work instruction and where it lives]

1. [One action with the exact label in bold: In **Search orders**, type …]
   ![Step 1](images/task-1-1-step-1.png)
2. [ ]
3. [ ]

- **Expected result:** [What is on screen when it worked]
- **If it fails:** [The common error and what to do, or who to ask]

## Task 1.2: [ ]

[Copy the task block above for every task in the module.]

## Check: Module 1

On test data, without the manual open. No quiz about menu names.

| # | Do this on test data | A correct result looks like | Done |
| --- | --- | --- | --- |
| 1 | [Task with the exact test record] | [What the trainer sees on screen] | [ ] |
| 2 | [ ] | [ ] | [ ] |
| 3 | [ ] | [ ] | [ ] |

Pass: [all tasks done without the manual open]. Checked by: [name], date: [ ].

# Module 2: [ ]

[Copy the Module 1 block. Order modules by what must be learnt first, then by how often the task comes up, then by what breaks if it is done wrong.]

# Reference

## Glossary

| Term in the tool | What it means here |
| --- | --- |
| [ ] | [ ] |

## Who to ask

| Topic | Name and channel |
| --- | --- |
| [ ] | [ ] |

## Change log

| Date | Module | What changed |
| --- | --- | --- |
| [ ] | [ ] | [ ] |