Merge branch 'stable'

Author: mpilgrem

doc/GUIDE.md

@@ -1480,6 +1480,21 @@ environment variable or using Stack's `--stack-root` option on the command line.
     `~/.config/stack` on Unix-like operating systems and `%APPDIR%\stack` on
     Windows.
 
+    This approach treats:
+
+    *   the project-level YAML configuration file that is common to all projects
+        without another such file in their project directory or its ancestor
+        directories as _data_ rather than as part of Stack's own
+        _configuration_;
+
+    *   the snapshots database as essential data rather than as non-essential
+        data that would be part of a _cache_, notwithstanding that Stack will
+        rebuild that database as its contents are needed; and
+
+    *   the Pantry store as essential data rather than as non-essential data
+        that would be part of a _cache_, notwithstanding that Stack will
+        download the package index and rebuild the store if it is absent.
+
 The location of the Stack root is reported by command:
 
 ~~~text

doc/README.md

@@ -335,7 +335,7 @@ The following assumes that you already have installed a version of Stack and the
 1.  Clone the `stack` repository from GitHub with the command:
 
     ~~~text
-    git clone https://github.com/commercialhaskell/stack.git`
+    git clone https://github.com/commercialhaskell/stack.git
     ~~~
 
 2.  Change the current working directory to the cloned `stack` directory with the

doc/install_and_upgrade.md

@@ -207,24 +207,24 @@ GitHub repository.
         There is also an unofficial package for openSUSE or SUSE Linux
         Enterprise. Its Stack version may lag behind. To install it:
 
-        === openSUSE Tumbleweed
+        === "openSUSE Tumbleweed"
 
             ~~~text
             sudo zypper in stack
             ~~~
 
-        === openSUSE Leap
+        === "openSUSE Leap"
 
             ~~~text
             sudo zypper ar http://download.opensuse.org/repositories/devel:/languages:/haskell/openSUSE_Leap_42.1/devel:languages:haskell.repo
             sudo zypper in stack
             ~~~
 
-        === SUSE Linux Enterprise 12
+        === "SUSE Linux Enterprise 12"
 
             ~~~text
             sudo zypper ar http://download.opensuse.org/repositories/devel:/languages:/haskell/SLE_12/devel:languages:haskell.repo
-            sude zypper in stack
+            sudo zypper in stack
             ~~~
 
     === "Ubuntu"