install_linux_distro.rst docs: updated to point user to latest stable branch adds a description of the semantic versioning convention that BuildStream uses adds a sentence telling users to follow this convention and navigate to the latest tag
diff --git a/doc/source/install_linux_distro.rst b/doc/source/install_linux_distro.rst index 0d21bfd..d07ef20 100644 --- a/doc/source/install_linux_distro.rst +++ b/doc/source/install_linux_distro.rst
@@ -1,4 +1,3 @@ - .. _install: Installing BuildStream on a Linux distro @@ -32,7 +31,15 @@ ------------------------------------ Until BuildStream is available in your distro, you will need to install it yourself from the `git repository <https://gitlab.com/BuildStream/buildstream.git>`_ -using python's ``pip`` package manager. +using python's ``pip`` package manager. + +BuildStream follows the semantic versioning convention `(SemVer) <https://semver.org>`_ +of releases and development snapshots. So where the version number is X.Y.Z +and the Y is an even number, you have a release, but where Y is an odd number, +you have a development snapshot. For example, 1.0 was the first ever release, +then 1.1 was the development branch that came after it, etc. Therefore, when +downloading from git, please look for the latest tag in the latest branch that +has an even number for Y. For the purpose of installing BuildStream while there are no distro packages, you will additionally need: