From 820721d2fa1c779751ac1a9078f18457da271ab4 Mon Sep 17 00:00:00 2001 From: Laurence Urhegyi Date: Tue, 14 Aug 2018 11:28:16 +0000 Subject: 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 --- doc/source/install_linux_distro.rst | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/doc/source/install_linux_distro.rst b/doc/source/install_linux_distro.rst index 0d21bfd46..d07ef2011 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 @@ Installing from source (recommended) ------------------------------------ Until BuildStream is available in your distro, you will need to install it yourself from the `git repository `_ -using python's ``pip`` package manager. +using python's ``pip`` package manager. + +BuildStream follows the semantic versioning convention `(SemVer) `_ +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: -- cgit v1.2.1