Green Software Foundation projects are required to maintain a standard set of files in each repository. This document describes the required and recommended files.
Repositories MUST have these files with the specific content in the linked files, or a file with a link to the specified content with minimal exposition. These files MUST be at the root of the repository.
(Or whatever licence is approved for use for this project)
Repositories MUST have these files. Named files MUST be at the root of the repository, and may have format suffixes such as
A description of the project and contain information or links to information such as
- A reference to the license (required).
- The current and important past releases
- Documentation for developers and users
Directions on how to contribute code to the project, or a pointer to the Wiki page with that information.
A human readable list of recent changes. Changes should at least include the current release. This file may be maintainer curated or mechanically produced.
- Continuous Integration / Continuous Delivery (CICD) configurations
Configurations needed to run CICD on Green Software Foundation provided systems.
Repositories SHOULD have these files. Named files SHOULD be at the root of the repository
- Build files consistent with the implementation language, such as…
- For Ruby a
- For Java one of a Maven
pom.xml, an Apache Ant
build.xml, or a Gralde
- For Python
- For Go
- For Rust a
- For multi-lingual repositories a
- For other languages, other standard build files a practitioner of the language would expect.
- Testing code
Code to test the code in the repository (such as unit tests), in a location appropriate for the language.
Not all repositories can be tested (homebrew, docs), which is the only reason this is a SHOULD.
Repositories MUST NOT have these files
- Executable binaries and shared library files built by code in the repository
.dylibfiles not otherwise part of a third party library.