Home / 🟠 AREAS / Knowledge Management / Contributing

Contributing

A change to the playbook is written in Markdown, checked in the preview, committed, and goes live within minutes of the push.

Workflow

1. Trigger: a process changes, or one is described for the first time.
2. Write: edit the page in docs/, following the Playbook template. A new page goes into mkdocs.yml and NAVIGATION.md in the same step.
3. Check: look at it in the preview and run the strict build.
4. Commit: to main, with a message that says what changed.
5. Push: a person approves and pushes. Cloudflare Pages builds the site and publishes it within a few minutes.
6. Result: the page is live at playbook-extern.abitello.com.

Rules

• AI agents commit; a person approves every push, because a push publishes.
• A page describes what is valid now. What is planned belongs elsewhere.