tertiary-learner-guide
Installation
SKILL.md
WSQ Learner Guide (Markdown + DOCX, aligned)
Single-source generator: author content once in the block DSL; it emits both
LEARNER-GUIDE.md (repo root) and courseware/<course> Learner Guide.docx.
Template: make_learner_guide.py (uses prodoc.py).
How to use
- Edit
make_learner_guide.py: setREPO,TITLE,VERSION,VERSIONS, and the content blocksB. - Use the helpers:
h1/h2/h3,p,steps,bullets,code,table,note,rule, plus("img", path, caption)for workflow screenshots. - Run
python3 make_learner_guide.py. The MD and DOCX are generated from the sameB, so they stay aligned. - Each activity should embed its workflow screenshot right after the "Goal" section (the generator does this via
insert_images).
Content rules
- Detailed step-by-step for every activity (numbered
steps), a Goal, a What you'll build node flow, and a Test it box. - A
0. Before You Startsetup section: accounts/API keys table, run-n8n (cloud + local Docker), credentials, and a GitHub download link for the workflows. - A Troubleshooting cheat-sheet and a Glossary table.
- Keep the MD and DOCX content identical (single source).