Requirements for public repos
This page is now obsolete. It is superseded by OEP-55: Project Maintainers.
(This is a proposal, comments welcome.)
If a GitHub repository is public, it must have:
A license, either AGPL or Apache. Here’s how to choose: https://openedx.atlassian.net/wiki/spaces/OPEN/pages/13959332
An openedx.yaml file. See OEP-2: Repository Metadata for details.
A README file (README.rst) with:
A sentence (ideally more) describing what the repo is. A brief summary of what it is for, and who might be interested is useful. More details can be covered in ADRs (described in OEP-19: Developer Documentation).
A link to the code of conduct: https://open.edx.org/code-of-conduct/
A mention of the license.
A statement about the repo’s contribution stance. For example:
“We welcome contributions”, with a link to a Contributing document [TODO: update a good org-wide contribution document.]
“We are not accepting public contributions to this repo.”
Contact information. This can simply be oscm@edx.org.
Security reporting information: “Please do not report security issues in public. Send security concerns via email to security@edx.org.”
A public repo should have:
A changelog
A link to documentation. There’s a variety of docs that could be available, described in OEP-19: Developer Documentation.
Information about how to report issues.
Where to go for help with the repo.
A public repo accepting contributions should have:
A pull request template