This document describes how we release Sourcegraph.

Release policies

[data:image/svg+xml;base64,PHN2ZyBjbGFzcz0ib2N0aWNvbiBvY3RpY29uLWluZm8gbXItMiIgdmlld2JveD0iMCAwIDE2IDE2IiB2ZXJzaW9uPSIxLjEiIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgYXJpYS1oaWRkZW49InRydWUiPjxwYXRoIGQ9Ik0wIDhhOCA4IDAgMSAxIDE2IDBBOCA4IDAgMCAxIDAgOFptOC02LjVhNi41IDYuNSAwIDEgMCAwIDEzIDYuNSA2LjUgMCAwIDAgMC0xM1pNNi41IDcuNzVBLjc1Ljc1IDAgMCAxIDcuMjUgN2gxYS43NS43NSAwIDAgMSAuNzUuNzV2Mi43NWguMjVhLjc1Ljc1IDAgMCAxIDAgMS41aC0yYS43NS43NSAwIDAgMSAwLTEuNWguMjV2LTJoLS4yNWEuNzUuNzUgMCAwIDEtLjc1LS43NVpNOCA2YTEgMSAwIDEgMSAwLTIgMSAxIDAgMCAxIDAgMloiIC8+PC9zdmc+](data:image/svg+xml;base64,PHN2ZyBjbGFzcz0ib2N0aWNvbiBvY3RpY29uLWluZm8gbXItMiIgdmlld2JveD0iMCAwIDE2IDE2IiB2ZXJzaW9uPSIxLjEiIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgYXJpYS1oaWRkZW49InRydWUiPjxwYXRoIGQ9Ik0wIDhhOCA4IDAgMSAxIDE2IDBBOCA4IDAgMCAxIDAgOFptOC02LjVhNi41IDYuNSAwIDEgMCAwIDEzIDYuNSA2LjUgMCAwIDAgMC0xM1pNNi41IDcuNzVBLjc1Ljc1IDAgMCAxIDcuMjUgN2gxYS43NS43NSAwIDAgMSAuNzUuNzV2Mi43NWguMjVhLjc1Ljc1IDAgMCAxIDAgMS41aC0yYS43NS43NSAwIDAgMSAwLTEuNWguMjV2LTJoLS4yNWEuNzUuNzUgMCAwIDEtLjc1LS43NVpNOCA2YTEgMSAwIDEgMSAwLTIgMSAxIDAgMCAxIDAgMloiIC8+PC9zdmc+)

As of RFC 864 the ownership of the release process has changed.

The Release Team is now the entity that owns the release process. Read more details about release responsibilities in the Releases section below.

Release Schedule

As of April 2024, Sourcegraph releases features monthly (see RFC 864) The 2024 schedule is as follows (version numbers are subject to change):

Version Release Date Release Kind
5.3.0 February 15, 2024 Minor
5.3.1 February 21, 2024 Patch
5.3.2 March 8, 2024 Patch
5.3.3 March 20, 2024 Patch
5.3.9104 April 5, 2024 Monthly
5.3.11625 April 18, 2024 Patch
5.3.12303 April 22, 2024 Patch
5.4.0 May 8, 2024 Monthly
5.4.2198 May 20, 2024 Patch
5.4.3500 May 27, 2024 Patch
5.4.3643 May 28, 2024 Patch
5.4.5099 June 5, 2024 Monthly
5.4.7765 June 20, 2024 Patch
5.5.0 July 10, 2024 Monthly
5.5.x July 24, 2024 Patch
5.5.x August 7, 2024 Monthly
5.5.x August 21, 2024 Patch
5.6.x September 4, 2024 Monthly
5.6.x September 18, 2024 Patch
5.6.x October 2, 2024 Monthly
5.6.x October 16, 2024 Patch
5.7.x October 30, 2024 Monthly
5.7.x November 13, 2024 Patch
5.7.x November 25, 2024 Monthly
5.7.x December 11, 2024 Patch
5.8.x December 18, 2024 Monthly

These releases may require manual migration steps.

Releases are the responsibility of the Release Team, and are performed by the team.

Feature releases may be in a minor version (3.0.0 -> 3.1.0), or a major version (3.0.0 -> 4.0.0). Releases are published with semantic versioning syntax, though Sourcegraph releases do not necessarily follow the versioning semantics.

Selecting Release Dates

The following are general guidelines for selecting release dates:

We chose day 5 to avoid holidays and other events at the beginning of the month, such as new quarterly review meetings and discussions. However, on some occasions these days fall on Friday or the weekend, so we generally consider the following criteria in the event the schedule above falls on a Friday or the weekend:

  1. Pick the next working day that isn't a Friday. This gives time for release prep.

Patch releases

Generally speaking patches will only include bug fixes for previously released features. In some occasions we may release improvements to address issues that may not technically a bug fix, and in some occasions we may backport features provided they are:

  1. Behind a feature flag