concept

GOVERNANCE.md

Facts (20)

Sources

Patterns in the Transition From Founder-Leadership to Community ... arxiv.org arXiv Feb 5, 2026 16 facts

referenceGOVERNANCE.md files function as an application of git version control software to assign responsibilities and provide clear community entry points into open-source software governance, following conventions established by CONTRIBUTING.md and CODE_OF_CONDUCT.md files.

referenceThe methodology for analyzing community governance transitions in open source projects compares three states of the GOVERNANCE.md file: the initial empty (0-byte) file, the initial formal expression of community management, and the latest, most mature version of the project's constitution.

accountTo study governance transitions from unitary to community models, researchers compiled a dataset of 637 open-source repositories to compare initial and latest snapshots of GOVERNANCE.md constitutions.

claimThe open-source software community has developed a standard for defining project governance on GitHub by using a uniform location and format for governing documents, specifically the GOVERNANCE.md file.

claimThe file GOVERNANCE.md has emerged as a de facto standard for codifying project rules in open source repositories, often accompanied by CONTRIBUTING.md, codes of conduct, and maintainership guides.

referenceThe Institutional Grammar (IG) framework, developed by Ostrom (2009) and Crawford and Ostrom (1995), is used to extract governance structures from GOVERNANCE.md constitution files in GitHub projects.

measurementAmong 710 analyzed repositories, 673 (94.8%) contained a GOVERNANCE.md file, while the remaining projects used 37 other filename variants.

claimConsequential governance rules in open source projects often reside outside of a primary GOVERNANCE.md file, appearing instead in files such as CONTRIBUTING.md, CODEOWNERS, CI settings, issue templates, or informal communication channels.

procedureThe researchers documented trajectories to community governance by extracting institutional roles, actions, and deontic cues from version-controlled project constitutions found in GOVERNANCE.md files.

claimInfluential open-source projects on GitHub, including node.js, Docker, and Jupyter, utilize public GOVERNANCE.md files to document policies regarding contributions, donations, planning, and other governance functions.

procedureThe study analyzes repository governance evolution by pairing the earliest recoverable GOVERNANCE.md snapshot with the latest snapshot for each repository.

claimGOVERNANCE.md files serve as an entry point for open-source software projects to transition from founder-owner leadership to accountable community governance.

measurementThe study defines 'Entropy' as a measure of the evenness of the distribution of governance categories, such as roles, actions, and deontics, across a GOVERNANCE.md snapshot, where higher entropy indicates a more uniform allocation of governance attention.

claimThe study provides a dataset comprising paired initial and latest GOVERNANCE.md snapshots from 637 Open Source Software (OSS) projects to enable the longitudinal study of explicit governance articulations.

claimBecause GOVERNANCE.md files are plain text files co-hosted with project code, they leverage git's version control and forking capabilities, allowing for the tracking of historical changes and enabling projects to learn from and adapt the institutional designs of other projects.

referenceThe paper 'Enabling the definition and enforcement of governance rules in open source systems' identifies the use of GOVERNANCE.md files as a standard for governance documentation in open source systems.

Governance in Practice: How Open Source Projects Define ... - arXiv arxiv.org arXiv 5 days ago 4 facts

procedureThe authors of 'Governance in Practice: How Open Source Projects Define and Document Roles' analyzed governance as an institutional infrastructure by using Institutional Grammar to extract and formalize role definitions from GOVERNANCE.md files in GitHub repositories.

claimOpen source software projects use governance files, such as GOVERNANCE.md, as socio-technical blueprints that document institutional arrangements and make participation pathways visible.

claimOpen source software projects use governance artifacts, such as GOVERNANCE.md files, as explicit records to describe community participation and formalize collaboration.

procedureThe researchers restricted their search for governance documentation to files containing the term 'governance,' based on GitHub's official documentation identifying GOVERNANCE.md as a file describing project governance.