From 6a58832286b9163337c1eddb892ecc5accdfa99f Mon Sep 17 00:00:00 2001
From: John Olheiser <42128690+jolheiser@users.noreply.github.com>
Date: Wed, 24 Apr 2019 13:44:58 -0500
Subject: [PATCH] Add FAQ for version downloads (#6742)
---
docs/content/doc/help/faq.en-us.md | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/docs/content/doc/help/faq.en-us.md b/docs/content/doc/help/faq.en-us.md
index c82583f360..1154141a09 100644
--- a/docs/content/doc/help/faq.en-us.md
+++ b/docs/content/doc/help/faq.en-us.md
@@ -18,6 +18,7 @@ menu:
This page contains some common questions and answers.
Also see [Support Options]({{< relref "doc/help/seek-help.en-us.md" >}})
+* [Difference between 1.x and 1.x.x downloads](#difference-between-1-x-and-1-x-x-downloads)
* [How to migrate from Gogs/GitHub/etc. to Gitea](#how-to-migrate-from-gogs-github-etc-to-gitea)
* [Where does Gitea store "x" file](#where-does-gitea-store-x-file)
* [Not seeing a clone URL or the clone URL being incorrect](#not-seeing-a-clone-url-or-the-clone-url-being-incorrect)
@@ -42,6 +43,17 @@ Also see [Support Options]({{< relref "doc/help/seek-help.en-us.md" >}})
* [LFS Issues](#lfs-issues)
+## Difference between 1.x and 1.x.x downloads
+Version 1.7.x will be used for this example.
+**NOTE:** this example applies to Docker images as well!
+
+On our [downloads page](https://dl.gitea.io/gitea/) you will see a 1.7 directory, as well as directories for 1.7.0, 1.7.1, 1.7.2, 1.7.3, 1.7.4, 1.7.5, and 1.7.6.
+The 1.7 and 1.7.0 directories are **not** the same. The 1.7 directory is built on each merged commit to the [`release/v1.7`](https://github.com/go-gitea/gitea/tree/release/v1.7) branch.
+The 1.7.0 directory, however, is a build that was created when the [`v1.7.0`](https://github.com/go-gitea/gitea/releases/tag/v1.7.0) tag was created.
+
+This means that 1.x downloads will change as commits are merged to their respective branch (think of it as a separate "master" branch for each release).
+On the other hand, 1.x.x downloads should never change.
+
## How to migrate from Gogs/GitHub/etc. to Gitea
To migrate from Gogs to Gitea: