summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTristan Van Berkom <tristan.vanberkom@codethink.co.uk>2018-08-25 20:08:18 +0900
committerTristan Van Berkom <tristan.van.berkom@gmail.com>2018-08-25 11:42:08 +0000
commita1fa504d580fc5ccbb0808389327c59ebd7e7d69 (patch)
tree70b9bcbb0d826979e4e27a949ea246ec7762072a
parentf7289b6bef31395a8e65a48dca87c5e4f1866fa4 (diff)
downloadbuildstream-a1fa504d580fc5ccbb0808389327c59ebd7e7d69.tar.gz
Add section about current releases
This is not ideal as the releases are hardcoded, but I think is better than nothing until we got a solution to automate this This commit was originally by Javier Jardón <jjardon@gnome.org> from merge request !661, and then later reworked into an install guide refactor.
-rw-r--r--doc/source/install_versions.rst18
-rw-r--r--doc/source/main_install.rst1
2 files changed, 19 insertions, 0 deletions
diff --git a/doc/source/install_versions.rst b/doc/source/install_versions.rst
new file mode 100644
index 000000000..381b4ec44
--- /dev/null
+++ b/doc/source/install_versions.rst
@@ -0,0 +1,18 @@
+
+
+Semantic Versioning
+===================
+BuildStream follows the Semantic Versioning Convention `(SemVer) <https://semver.org/>`_,
+and uses even minor point numbers to denote releases intended for users while
+odd minor point numbers represent development snapshops.
+
+For example, for a given version number ``X.Y.Z``
+ * The ``X.<even number>.*`` versions are releases intended for users.
+ * The ``X.<odd number>.*`` versions are development spanshots intended for testing.
+
+If you are :ref:`installing from git <install_git_checkout>`, please look for the latest
+tag in the latest release branch to ensure you're getting the latest release.
+
+Current release branches:
+ * `bst-1.2 (latest) <https://gitlab.com/BuildStream/buildstream/commits/bst-1.2>`_
+ * `bst-1.0 (deprecated) <https://gitlab.com/BuildStream/buildstream/commits/bst-1.0>`_
diff --git a/doc/source/main_install.rst b/doc/source/main_install.rst
index fda886f54..a52c81512 100644
--- a/doc/source/main_install.rst
+++ b/doc/source/main_install.rst
@@ -19,3 +19,4 @@ BuildStream inside a docker image and also how to configure an artifact server.
install_linux_distro
install_docker
install_artifacts
+ install_versions