How to Contribute to the Pyragogy Handbook
-
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
Hello! It looks like you're interested in this conversation, but you don't have an account yet.
Getting fed up of having to scroll through the same posts each visit? When you register for an account, you'll always come back to exactly where you were before, and choose to be notified of new replies (either via email, or push notification). You'll also be able to save bookmarks and upvote posts to show your appreciation to other community members.
With your input, this post could be even better 💗
Register Login