From e6340c6e54a572d58bc1039430a8f3a461635f00 Mon Sep 17 00:00:00 2001
From: Tim Abbott <tabbott@zulipchat.com>
Date: Fri, 23 Aug 2019 16:32:37 -0700
Subject: [PATCH] docs: Make production unreleased documentation notices more
 visible.

Previously, Google might take you to /latest rather than /stable, and
you might get information about the next release, not the current one.

Fixes #13056.
---
 docs/production/install.md      | 36 ++++++++++++++++-----------------
 docs/production/requirements.md | 18 +++++++++++++++++
 2 files changed, 36 insertions(+), 18 deletions(-)

diff --git a/docs/production/install.md b/docs/production/install.md
index 6359942a46..00a0e26836 100644
--- a/docs/production/install.md
+++ b/docs/production/install.md
@@ -1,5 +1,23 @@
 # Production Installation
 
+<!---
+  The `.. only:: unreleased` syntax invokes an rST "directive"
+  called `only`, defined by Sphinx:
+    https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#including-content-based-on-tags
+  It's controlled by `docs/conf.py` through the `tags` object.
+-->
+
+```eval_rst
+.. only:: unreleased
+
+   .. warning::
+      You are reading a **development version** of the Zulip documentation.
+      These instructions may not correspond to the latest Zulip Server
+      release.  See `documentation for the latest release`__.
+
+__ https://zulip.readthedocs.io/en/stable/production/install.html
+```
+
 You'll need an Ubuntu or Debian system that satisfies
 [the installation requirements](../production/requirements.html). Alternatively,
 you can use a preconfigured
@@ -32,24 +50,6 @@ using code from our [repository on GitHub](https://github.com/zulip/zulip/).
 
 ## Step 2: Install Zulip
 
-<!---
-  The `.. only:: unreleased` syntax invokes an rST "directive"
-  called `only`, defined by Sphinx:
-    https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#including-content-based-on-tags
-  It's controlled by `docs/conf.py` through the `tags` object.
--->
-
-```eval_rst
-.. only:: unreleased
-
-   .. warning::
-      You are reading a **development version** of the Zulip documentation.
-      These instructions may not correspond to the latest Zulip Server
-      release.  See `documentation for the latest release`__.
-
-__ https://zulip.readthedocs.io/en/stable/prod-install.html
-```
-
 To set up Zulip with the most common configuration, you can run the
 installer as follows:
 
diff --git a/docs/production/requirements.md b/docs/production/requirements.md
index 8179c0656b..b8a58f402d 100644
--- a/docs/production/requirements.md
+++ b/docs/production/requirements.md
@@ -1,5 +1,23 @@
 # Requirements
 
+<!---
+  The `.. only:: unreleased` syntax invokes an rST "directive"
+  called `only`, defined by Sphinx:
+    https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#including-content-based-on-tags
+  It's controlled by `docs/conf.py` through the `tags` object.
+-->
+
+```eval_rst
+.. only:: unreleased
+
+   .. warning::
+      You are reading a **development version** of the Zulip documentation.
+      These instructions may not correspond to the latest Zulip Server
+      release.  See `documentation for the latest release`__.
+
+__ https://zulip.readthedocs.io/en/stable/production/requirements.html
+```
+
 To run a Zulip server, you will need:
 * A dedicated machine or VM
 * A supported OS: