I am reworking and improving on the Playbook we used to run participation sessions in Whistler, which got me thinking about how to better expose this content, and invite others to both use this material in their own areas, and improve if they see the need.
My preference is to avoid keeping things like this in Google Docs, and instead making it findable in a Github repository as I do the community curriculum. My reasons are:
- Github makes it easy for community to contribute improvements.
- Standard for content would be Markdown which makes content modular - and super-easy to export (including cut & paste to a wiki). It’s also what we use for community curriculum, so it’s been tested.
- It ties into our Heartbeat platform.
- People can propose improvements, or report issues via Github issues.
I have loosely (meaning I am not super-attached to this) proposed a Participation (github.com/mozilla/participation) repository for resources we are building vrs a single repo for each resource. The directory might look something like this:
Workshops
- Play Book
- Leadership Training
- Mentor Training
- Community Onboarding
Design Resources - Participation Personas
- Designing Participation ‘Steps’ and Ladders
And So On - Something
And So Forth - Another Something
Wondering people’s thoughts on this. I will 100% admit I like using the Wiki for documentation but not for living, and dynamic documents - or what I feel is a project like building resources for participation. Alternate approaches might be to have one repo for each category ie: participation-workshops or that each resource have it’s own repo entirely (which is where I think things start getting lost)