This page is about writing documentation for tools we have. For safety (and insurance) reasons, almost every tool should have:

1. One or more tool owners, who have a good idea how it works & how to use it. These don't need to be the actual 'owners', if it's a long term loan.
2. A risk assessment, if it has any non-negligible risk. If you're not sure, ask!
3. A training syllabus, usually. You may be able to skip this if:
   1. There's no risk assessment, or the risk assessment doesn't say “users will do <X>”
   2. The tool has a manual, and we use it like in the manual
4. A wiki page, which lists all of the above

Usually, the 'tool owners', instructors, or most regular users of the tool are responsible for this. The good news is that making this shouldn't take long, and there are plenty of people to help you.

If you're reading this, there's a good chance you already have this. Usually, the tool owners are people who:

• Have used the same/similar tools before
• Have at least some time and effort to teach others
• Know what they're doing

This is the most boring part, but is usually also the easiest. We have a generator for it, so you just need to edit some markdown:

1. Fork the edinburghhacklab/hacklab-training repository.
2. On a Linux machine (or one with Docker), clone your fork
3. Run ./scripts/open.sh. This should build a local copy of the documentation, and open the landing page for it.
4. Run ./scripts/new-tool.sh "<tool name>" "<tool location>", ie ./scripts/new-tool.sh "Lathe" "Workshop". This should create a risk assessment and a syllabus for your tool, based off of a template, and print out their paths.
5. Edit the path ending in risk-assessment.md. To rebuild your local copy, run ./scripts/generate.sh "<tool name>" to rebuild only your tool's documentation, or skip the tool name to rebuild everything.

To write the actual content of your risk assessment:

1. Make a list of everything that could go wrong, that could harm a person or the environment. The things might happen because of:
   1. The tool being broken
   2. The tool being misused
   3. Bad luck
2. Decide on its severity: how bad it is if it happens, in the worst case.
   1. If someone could die or lose a limb, its high
   2. If someone could give themselves injuries lasting weeks to months, its medium
   3. If someone could give themselves a scrape or bruise, its low.
   4. If in doubt, round up.
3. Decide how to mitigate it.
   1. This could be by keeping it in a certain environment, maintaining it properly, etc.
   2. Often, this involves 'the user will not do X'
4. Decide how likely it is to happen, bearing in mind the mitigation you just decided on.
   1. This is quite subjective, so consider getting a 2nd opinion
5. Decide on the overall 'risk rating'
   1. There should be a comment on how to decide this in the template.
6. Put it in the template, rinse and repeat until you run out of horrible accidents to imagine.

To make this easier, you can look at other people and makerspace's risk assessments, for example:

• Makespace cambridge
• Southampton makerspace
• NottingHack

TODO

TODO