Starting point for a new May Ethereal repository. Creating a repository from this template gives you the files every project in the organization is expected to have, already wired to the organization-wide security scan.
| File | Purpose |
|---|---|
README.md |
This file — replace it with the project's own README |
LICENSE |
GNU GPL v3.0 text, matching the license most of our repositories use |
SECURITY.md |
Points at the organization security policy, so reports reach the right inbox |
CONTRIBUTING.md |
Points at the organization contribution guidelines |
CODEOWNERS |
Requests review from the organization maintainers |
.gitignore |
Build output, editor state and local environment files |
.github/workflows/ci.yml |
Runs the organization-wide secret and dependency scan on every pull request |
- Replace
README.mdwith the project's own README. A good one states what the project is, how to build it, how to run it, and what it deliberately does not do. - Confirm the license.
LICENSEholds GPL-3.0, the license used by most of our repositories. If the project needs a different license, replace the file and state the new SPDX identifier in the README. - Add the build pipeline for the project's language. The template CI only
runs the organization security scan; the real build belongs in
.github/workflows/. - Adjust
CODEOWNERSto the people who actually review this project. - Set the repository description, enable branch protection, and turn on Dependabot alerts. The organization policies are in repository standards and release policy.
# <name>
One paragraph: what this project is and who it is for.
## Build
Exact commands that build from a clean checkout.
## Run
Exact commands that run it.
## What it does not do
Platforms that are not supported and behaviour that is intentionally absent.
## Dependencies
Table of dependencies and the versions they are pinned to.
## License
SPDX identifier and a link to the license file.