Contributing to the Handbook
The Pyragogy Handbook is community property. The process for contributing should be accessible to anyone willing to engage seriously.
The Handbook Structure
The handbook lives in a GitHub repository (confirm URL with @Fabry — link pending final setup). It’s organized into:
Foundations — Core concepts and Cognitive Rhythm framework
Patterns — Validated patterns in formal template format
Practices — How-to guides and process documentation
Stories — Case studies and experiment records
Resources — Annotated bibliography and tool references
Three Ways to Contribute
Path 1: Forum-First (Recommended for New Contributors)
Post your contribution in the appropriate Archive subcategory
Let the community discuss and refine it
When there’s rough consensus, tag a maintainer
Maintainer creates the GitHub PR or helps you create one
Best for: Pattern contributions, new sections, anything where community input helps.
Path 2: Direct GitHub PR
Fork the repository
Create a branch: contrib/[your-handle]-[short-description]
Make your changes following the style guide
Submit a PR with clear description of what you changed and why
Request review from at least one maintainer
Best for: Corrections, small improvements, people comfortable with Git.
Path 3: Suggest, Don’t Write
Post in Handbook Contributions with [PROPOSAL] in the title. Describe what you think should be added and why.
Content Standards
What we’re looking for:
Tested claims (not “AI can do X” — “we tried X and here’s what happened”)
Clear examples (not just abstract descriptions)
Acknowledged uncertainty (don’t claim more than you know)
Disclosed AI assistance
What we’re not looking for:
Claims that haven’t been tested in practice
Content that could have been written without engaging with Pyragogy specifically
Attribution
Contributors are credited in the handbook’s contributor file. AI assistance is noted with the human author credited as primary.
This is your work. The handbook is better because you contributed. That matters.
Human-AI Co-Creation
