pelias / pelias/documentation

Document how we do releases, how we build docker images, etc

Open
#263 0 comments 0 reactions 1 assignee View on GitHub

@orangejulius is already working on this.

Since Mar 11, 2020.

Dominant language
No language data
Stars
269
Forks
104
PR merge metrics
No merged PRs in 30d

Description

We don't have much documentation to tell people how we manage releases for Pelias.

Some things that would be useful to mention:

  • In general, we run a rolling release process where people are generally best off using the latest master branch.
  • We publish releases using semantic-release and using semantic versioning
  • Releases for each component of pelias are well described in the GitHub releases page for each repo
  • Each release of the "primary" Pelias repositories (Pelias services, importers, schema) have Docker images built for each branch, and for each commit
  • In the case where we have to make a breaking change, we will call this out in the release notes for the affected projects, and generally follow the rule that we will try to make breaking changes that are backwards/forwards compatible with at least 1 or 2 months leeway

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.