# Contribution Pathways Must Be Documented Not Left Emergent ## Claim A foundation or open-source project converts willing participants into active contributors only when the route from intent to action is an explicit, owned artifact, not something people are left to discover on their own. <!-- atomicity: 1 idea ✓ --> ## Scope & conditions - Holds for any community wanting sustained contribution beyond its earliest, smallest core, where the path is no longer obvious to everyone by osmosis. - Breaks when a project is small enough that the path is genuinely self-evident, or when "documentation" exists on paper but the decision rights behind each rung stay undefined — a documented ladder with no real authority at the top is still a foggy path with better branding. - This is about the existence and ownership of the pathway artifact itself, not about any particular ladder design (working group → committee → publish → speak is one instance, not the claim). ## Evidence AAIF (a young open agentic-AI standards foundation) reports that members arrived with production-tested insight and a genuine will to contribute, but the route from that intent to real action "stayed foggy" — the foundation had built structures (working groups, a blog, committees) without yet building the connective tissue linking people to them. Its response was to publish a concrete, named ladder: chair or co-chair a working group, propose a new one, sit on a committee, publish vendor-neutral, or speak at events. > [!quote] > You build the structure, then you build the connective tissue between the people and the structure. ## Links - [[Open Source Governance MOC]] — the conversion step between willing participants and active contributors - [[3. Resources/Permanent Notes/A Contribution Pipeline Needs a Defined Next Step After Training]] — because extends: that note is the narrower case (the post-training handoff specifically); this note generalizes the same underlying failure mode to any point where a willing contributor lacks a documented next step, not only after formal training ends. - [[3. Resources/Permanent Notes/Open Source Education Works as a Three-Stage Contribution Funnel]] — because evidence-for: WordPress's Campus Connect → Credits → Student Clubs funnel is a working example of exactly the documented, owned pathway this claim argues is necessary. - [[DevRel MOC]] — the conversion step between a willing participant and an active contributor, which is DevRel's core job - [[3. Resources/Permanent Notes/A Decision Log Is How a Nebulous Role Becomes Inheritable]] — because extends: the same rule applied to the role at the far end of the pathway, where what needs documenting is judgment rather than route. ## Tests / falsifiers - Audit a contributor program for whether a willing new participant can trace their next concrete action in under five minutes without asking a human — failure here would confirm the gap this claim predicts; success across many programs without documentation would weaken the claim's necessity. - Track whether AAIF's published ladder actually increases member-led working-group chairs and blog posts over the following two quarters — if participation doesn't move, the documentation itself wasn't the binding constraint. ## Maintenance - Last tended: 2026-08-16 - Next review: 2026-11-16 ## Source - [[3. Resources/Readwise/Articles/A Stronger Voice What Membership Can Mean in Open Agentic AI|A Stronger Voice - What Membership Can Mean in Open Agentic AI]] — AAIF blog post announcing expanded member participation channels.