config overview: replace extended yaml examples with pointer to 'complex config' page

sporksmith · sporksmith · commit 545237ea04c1 · 2022-12-13T12:07:04.000-06:00
diff --git a/docs/shadow_config_overview.md b/docs/shadow_config_overview.md
@@ -79,72 +79,10 @@ Examples: `20 B`, `100 MB`, `100 megabyte`, `10 kibibytes`, `30 MiB`, `1024 Mbyt
 
 ## YAML Extensions (Experimental)
 
-Shadow has experimental support for extended YAML conventions. These can be
-enabled using the `--use-extended-yaml true` command line option.
-
-### Merge/Override Mappings
-
-To help reduce repeated configuration options, Shadow supports the YAML ["merge
-key (`<<`)"](https://yaml.org/type/merge.html) convention. This merges the keys
-of the child mapping into the parent mapping, and is useful when combined with
-[YAML anchors (`&` and `*`)](https://yaml.org/spec/1.2.2/#692-node-anchors).
-
-Example:
-
-```yaml
-general:
-  # --snip--
-
-network:
-  # --snip--
-
-hosts:
-  server:
-    # --snip--
-  client-uk: &client
-    network_node_id: 0
-    processes:
-    - path: /usr/bin/curl
-      args: server --silent
-      start_time: 5
-  client-us:
-    network_node_id: 1
-    <<: *client
-```
-
-For a longer example, see
-https://support.atlassian.com/bitbucket-cloud/docs/yaml-anchors/.
-
-### Extension Fields
-
-When using the "merge key" feature above, putting common options in a separate
-configuration fragment may help make the configuration more readable. Shadow
-supports the "extension field" convention used by [Docker
-Compose](https://docs.docker.com/compose/compose-file/compose-file-v3/). Any
-top-level field containing a key that begins with `x-` will be ignored by
-Shadow.
-
-Example:
-
-```yaml
-x-client: &client-defaults
-  processes:
-  - path: /usr/bin/curl
-    args: server --silent
-    start_time: 5
-
-general:
-  # --snip--
-
-network:
-  # --snip--
-
-hosts:
-  server:
-    # --snip--
-  client-uk:
-    network_node_id: 0
-    <<: *client-defaults
-  client-us:
-    network_node_id: 1
-    <<: *client-defaults
+Shadow has experimental support for extended YAML conventions. When these are
+enabled using the [`--use-extended-yaml true`](./shadow_config_spec.md#experimentaluse_extended_yaml) command line option, Shadow
+supports [merge keys](https://yaml.org/type/merge.html)
+and [extension
+fields](https://docs.docker.com/compose/compose-file/#extension)).
+
+For examples, see [Managing Complex Configurations](./shadow_config_complex.md).
