mapbox / mapbox/mason

PSA: Don't use moving targets as release names

Open
#213 2 comments 9 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
258
Forks
68
PR merge metrics
No merged PRs in 30d

Description

I noticed there are a few packages that use branch names, or something like `latest` as their release version. Please don't do this; mason doesn't automatically update those releases when the source code changes, so a `latest` package is outdated very quickly.

If you want to create a package that is not an actual release, please use a date and/or a commit hash as the version name, e.g. [`rapidjson 2016-07-20-369de87`](https://github.com/mapbox/mason/tree/master/scripts/rapidjson/2016-07-20-369de87). While the commit hash is enough for uniquely identifying the release, adding a date means that it's easier for humans to figure out what the newest release is.

/cc @springmeyer @jfirebaugh @mikemorris @brunoabinader @rclark @flippmoke @artemp @mourner @morganherlocker @tmpsantos @mapsam @yhahn @lbud @danpat @ansis @bleege @bhousel @TheMarex @1ec5 @daniel-j-h @friedbunny @ajashton @BergWerkGIS @camillacaros @mapbox/cpp

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.

Research direction

The issue names no files, tests, or entry points. Inspect mason's package release and version-naming workflow for branch names or moving labels such as `latest`; done means non-release packages use a date and/or commit hash and no longer rely on moving targets.

Written by the indexing model from the issue text.

Assessment

Domain
release
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.