Contributing to the Chapter Playbook¶
Before creating or moving content into this repository, use the Information Classification Guide to confirm that it belongs in public documentation. This classification check gates every contribution.
If you are gathering missing dates, owners, policies, chapter details, or product context, start with the Factual Information Audit. It identifies the exact fact, preferred source, approving owner, and privacy boundary needed across the repository.
Submit a chapter year¶
- Create a branch named
docs/[chapter]-[academic-year]. - Open your file under
docs/chapters/. - Copy the yearly archive template into the yearly archive.
- Write one short paragraph for Fall and one for Spring.
- Run
python scripts/validate_docs.pyandpython -m mkdocs build --strictwhen available. - Commit the source and regenerated
site/directory. - Open a merge request titled
docs: add [chapter] [academic year] archive.
Public-content checklist¶
- [ ] Content is classified as public using the Information Classification Guide
- [ ] No member, applicant, or alumni roster information
- [ ] No personal email addresses, phone numbers, or private social profiles
- [ ] No passwords, recovery details, restricted links, or access instructions
- [ ] No private budgets, account numbers, payment details, or confidential sponsor terms
- [ ] No disciplinary, academic, health, or other sensitive personal information
- [ ] No company information that is confidential or awaiting approval
- [ ] Event results use approximate attendance or cost bands where appropriate
- [ ] The submission explains reusable lessons, not only what happened
Review standard¶
A reviewer should check accuracy, usefulness to another chapter, public safety, and whether the entry distinguishes one chapter's experience from organization-wide policy.