← All courses

How to Participate

Report problems, improve existing courses, or write a new one.

Ways to help

Writing a new course

Every course is its own repo under the yaaddi-courses organization.

  1. Click Use this template on yaaddi-courses/course-template to create the new course repo.
  2. Follow that repo's README and AUTHORING.md — deck structure, card-type variety, how many practice cards per concept, meta.json fields, and more.
  3. In the repo, run the validator: python validate_course.py . --source — it catches dangling references, missing media, unknown card types, and more. Then build the zip: python build_course_zip.py .
  4. The repo's own workflow runs the same validator on every pull request and push.
  5. Once it is merged to main, add the yaaddi-course topic to the repo. The catalog picks it up on its next scheduled rebuild (every 6 hours) — no pull request against the catalog is needed.

License

Course content is licensed under PolyForm Noncommercial 1.0.0 — each course repo carries its own LICENSE. If you're contributing a course built from a source with its own license, say so in that course's own repo rather than assuming.