Add docs about preference for tags over branches (#3582)

readthedocs · Feb 9, 2018 · 8f3d80f · 8f3d80f
1 parent 483a7a5
commit 8f3d80f
Showing 1 changed file with 7 additions and 2 deletions.
diff --git a/docs/versions.rst b/docs/versions.rst
@@ -40,6 +40,13 @@ which are branches that are maintained over time for a specific release number.
 
 .. _PEP 440: https://www.python.org/dev/peps/pep-0440/
 
+Tags and branches
+-----------------
+
+Read the Docs supports two workflows for versioning: based on tags or branches.
+If you have at least one active tag,
+tags will take preference over branches when selecting the stable version.
+
 Redirects on root URLs
 ----------------------
 
@@ -48,5 +55,3 @@ for example ``http://pip.readthedocs.io/``,
 they will be redirected to the **Default version**.
 This defaults to **latest**,
 but could also point to your latest released version.
-
-