diff --git a/README.md b/README.md index 33aa4f21f..7752e4654 100644 --- a/README.md +++ b/README.md @@ -12,24 +12,31 @@ the software supply chain. SPDX reduces redundant work by providing a common format for companies and communities to share important data about software licenses and copyrights, thereby streamlining and improving compliance. -## Specification development +Current stable version: -The specification is comprised of documents located in the `docs/` directory -of this `spdx/spdx-spec` repository, as well as a model documentation -generated from Markdown files within the -[spdx/spdx-3-model](https://github.com/spdx/spdx-3-model/) repository. +- The current stable specification is available at: + + +Next version (work in progress): + +- A preview of the next version, currently under active development, is + available at: + + (This website is automatically updated with each commit to the `develop` + branch). -This `spdx/spdx-spec` repository holds under active development version -of the specification as: +Translations of the specification may be available. +English remains the normative language in all cases. -- Markdown: - [`development/v3.0.1`](https://github.com/spdx/spdx-spec/tree/development/v3.0.1/docs) - branch -- HTML: `gh-pages` branch, built on every commit to the development branch - - Current stable (v3.0.1): - +## Specification development + +The specification comprised of documents located in the [`docs/`](./docs/) +directory of this `spdx/spdx-spec` repository, +as well as a model documentation generated from Markdown files within the +[spdx/spdx-3-model](https://github.com/spdx/spdx-3-model/) repository. -Contributions are welcome. Contributions to this repository are made pursuant to the +Contributions, including translations, are welcome. +Contributions to this repository are made pursuant to the [SPDX Community Specification Contributor License Agreement 1.0](https://github.com/spdx/governance/blob/main/0._SPDX_Contributor_License_Agreement.md). Please see the contributing guidelines, governance practices, and build instructions in the @@ -49,14 +56,16 @@ This repository consists of these files and directories (partial): - `front/` - Front matter. - `images/` - Model diagrams. These image files are to be generated from a diagram description file - [model.drawio](https://github.com/spdx/spdx-3-model/blob/main/model.drawio) - in `spdx/spdx-3-model` repo and manually copied here. + [model.drawio](https://github.com/spdx/spdx-3-model/blob/develop/docs/model.drawio) + in the `spdx/spdx-3-model` repo and manually copied here. - `licenses/` - Licenses that used by the SPDX specifications. - `model/` - Model files. This subdirectory _is to be created_ by a script from `spdx/spec-parser` repo, using model information from - `spdx/spdx-3-model` repo (see the build instructions below). + `spdx/spdx-3-model` repo (see the [build instructions](./build.md)). - `examples/` - Examples of various SPDX serializations for the current version of the spec. +- `rdf/` - Model RDF files. These ontology files are generated from model + Markdown files in the `spdx/spdx-3-model` repo and manually copied here. - `mkdocs.yml` - MkDocs recipe for the spec documentation generation. The inclusion of model files and the order of chapters are defined here. @@ -67,9 +76,22 @@ The SPDX spec repo follows the [Gitflow](https://gist.github.com/HeratPatel/271b The branches in use are: - `main` - This will always be the latest released specification. -- `develop` - This branch will be where the active development for the next major or minor version takes place. Once released, the `develop` branch will be merged into the `main` branch. -- `support/x.y` - These branches will be long lived and contain any updates to a minor version of the specification. Additions such as translations can be added to the support branch. `x.y` represents the major.minor version. Once any changes are accepted and released, the support branch will be tagged and merged into both the develop and main branches. -- General feature or fix branches - there may be feature branches made for specific enhancements or fixes to the spec. These will be short lived and merged into either a support branch or the develop branch. +- `develop` - This branch will be where the active development for the next + major or minor version takes place. + Once released, the `develop` branch will be merged into the `main` branch. +- `support/x.y` - These branches will be long-lived and contain any updates to + a minor version of the specification. + Additions such as translations can be added to the support branch. + `x.y` represents the MAJOR.MINOR version, following Semantic Versioning + (SemVer) conventions. + Once any changes are accepted and released, the support branch will be tagged + and merged into both `develop` and `main` branches. +- General feature or fix branches - there may be feature branches made for + specific enhancements or fixes to the spec. + These will be short-lived and merged into either a `support` branch or the + `develop` branch. +- `gh-pages` - This branch hosts generated HTML websites for all versions of + the specification. It is primarily managed by an automated workflow. ## Related documents and repositories