Initial commit

2026-07-30 11:30:05 +00:00
commit e246c01af7
3 changed files with 65 additions and 0 deletions
@@ -0,0 +1,39 @@
+# __CLIENT__-eec-courses
+
+Course content for [eec](https://gitea.reground.org/will/eec), the self-paced
+email course engine — this instance served at eec.__DOMAIN__. Push to
+`master` and CI syncs `courses/` straight to production — there's no staging
+step, so treat a push here the same as a push to `eec` itself.
+
+Full reference for course/step file format, `course.yml` fields, the
+readiness step, drip-triggered courses, and sync guardrails lives in the
+[`eec-courses`](https://gitea.reground.org/will/eec-courses) README — the
+format is identical, only the target instance differs.
+
+## Layout
+
+```
+courses/
+  <slug>/
+    course.yml
+    day-0.md
+    day-1.md
+    ...
+```
+
+## Deploying
+
+Push to `master` → `.gitea/workflows/sync.yml` tars up `courses/` and
+`POST`s it to this domain's `eec-__CLIENT__` container over the internal
+Docker network, authenticated with `__CLIENT___EEC_SYNC_TOKEN` (a Gitea
+Actions secret shared with the `eec-__CLIENT__` Ansible role's copy). No
+separate deploy step, no staging — a push here goes live immediately.
+
+---
+
+**Generating a new client repo from this template:**
+
+1. Gitea → "Generate Repo" from this template repo's page, named `<client>-eec-courses`.
+2. Find/replace `__CLIENT__` → the client's slug (must match the `eec-<client>` container name) and `__DOMAIN__` → the client's domain, in this README and in `.gitea/workflows/sync.yml`.
+3. Add the `<CLIENT>_EEC_SYNC_TOKEN` Actions secret to the new repo (Gitea does not carry secrets over from a template) — value must match the `eec-<client>` Ansible role's copy.
+4. Delete this "Generating a new client repo" section from the new repo's README once done.