Merge branch 'stable'

Author: mpilgrem

doc/commands/build_command.md

@@ -1028,7 +1028,8 @@ All the following examples assume that:
     consequently, the project-level configuration will be determined by a
     `stack.yaml` file in the `global-project` directory in the
     [Stack root](../topics/stack_root.md) (for further information, see the
-    [YAML configuration](../configure/yaml_configuration.md) documentation); and
+    [YAML configuration](../configure/yaml/yaml_configuration.md)
+    documentation); and
 
 *   if `stack build` is commanded in a project directory, there is a
     `stack.yaml` file in that directory.

doc/commands/index.md

@@ -1,11 +1,14 @@
+---
+title: Commands
+---
 <div class="hidden-warning"><a href="https://docs.haskellstack.org/"><img src="https://cdn.jsdelivr.net/gh/commercialhaskell/stack/doc/img/hidden-warning.svg"></a></div>
 
 # Commands (advanced)
 
 Some of Stack's features will not be needed regularly or by all users. This part
 of the guide and the part on [configuration](../configure/index.md) provide
-information about somethose features, organised as a reference guide. Some of
-the features are complex and separate pages are dedicated to them.
+information about some of those features, organised as a reference guide. Some
+of the features are complex and separate pages are dedicated to them.
 
 ## Stack commands (thematic)
 

doc/configure/environment_variables.md

@@ -88,15 +88,15 @@ sequences for color to its output.
 ## `STACK_CONFIG`
 
 Related command: all commands that make use of Stack's
-[global YAML configuration files](yaml_configuration.md) (`config.yaml`).
+[global YAML configuration files](yaml/yaml_configuration.md) (`config.yaml`).
 
 The environment variable `STACK_CONFIG` can be used to specify an absolute path
 to the user-specific global YAML configuration file, overriding the default.
 
 ## `STACK_GLOBAL_CONFIG`
 
 Related command: all commands that make use of Stack's
-[global YAML configuration files](yaml_configuration.md) (`config.yaml`).
+[global YAML configuration files](yaml/yaml_configuration.md) (`config.yaml`).
 
 The environment variable `STACK_GLOBAL_CONFIG` can be used to specify an
 absolute path to the system-wide global YAML configuration file, overriding the
@@ -105,7 +105,7 @@ default.
 ## `STACK_ROOT`
 
 Related command: all commands that make use of Stack's
-[user-specific global YAML configuration file](yaml_configuration.md)
+[user-specific global YAML configuration file](yaml/yaml_configuration.md)
 (`config.yaml`).
 
 Overridden by: Stack's global
@@ -131,7 +131,7 @@ the root directory of the project or package. The relative path cannot include a
 ## `STACK_XDG`
 
 Related command: all commands that make use of Stack's
-[user-specific global YAML configuration file](yaml_configuration.md)
+[user-specific global YAML configuration file](yaml/yaml_configuration.md)
 (`config.yaml`).
 
 Overridden by: the use of Stack's `STACK_ROOT` environment variable, or the use
@@ -145,7 +145,7 @@ set to any non-empty value.
 ## `STACK_YAML`
 
 Related command: all commands that make use of Stack's
-[project-level YAML configuration file](yaml_configuration.md).
+[project-level YAML configuration file](yaml/yaml_configuration.md).
 
 Overridden by: Stack's global
 [`--stack-yaml`](global_flags.md#-stack-yaml-option) option.

doc/configure/index.md

@@ -1,11 +1,14 @@
+---
+Title: Configure
+---
 <div class="hidden-warning"><a href="https://docs.haskellstack.org/"><img src="https://cdn.jsdelivr.net/gh/commercialhaskell/stack/doc/img/hidden-warning.svg"></a></div>
 
 # Configuration (advanced)
 
 Some of Stack's features will not be needed regularly or by all users. This part
-of the guide and the part on [Stack's commands](commands/index.md)
-provide information about those features, organised as a reference guide. Some
-of the features are complex and separate pages are dedicated to them.
+of the guide and the part on Stack's [commands](../commands/index.md) provide
+information about those features, organised as a reference guide. Some of the
+features are complex and separate pages are dedicated to them.
 
 The behaviour of Stack is configurable using environment variables, YAML
 configuration files, global flags and options on the command line and