diff --git a/proxy/config/parents.yaml.example b/proxy/config/parents.yaml.example
new file mode 100644
index 00000000000..502b437041f
--- /dev/null
+++ b/proxy/config/parents.yaml.example
@@ -0,0 +1,80 @@
+
+## remap.config
+map /foo http://bob parents=foo.yaml
+map /bar http://bob parents=bar.yaml
+map /leif http://bob parents=ourhosts.yaml,bar.yaml # if we didn't have a include thing
+
+##
+# ourhosts.yaml
+hosts:
+  p1: &anchornameforp1 # shorthand name of host object, with an "anchor name"
+    host: p1.foo.com  # name or IP of host
+    protocol:
+      - http: 80
+      - https: 443
+    healthcheck:
+      url: tcp://192.168.1.1:80
+    future_stuff: "..."
+  p2: &anchornameforp2
+    host: p2.foo.com
+    protocol:
+      - http: 80
+      - https: 443
+    healthcheck:
+      url: tcp://192.168.1.2:80
+    future_stuff: "..."
+  s1: &anchornamefors1
+    host: s1.bar.com
+    protocol:
+      - http: 80
+      - https: 443
+    healthcheck:
+      url: tcp://192.168.2.1:80
+  s2: &anchornamefors2
+    host: s2.bar.com
+    protocol:
+      - http: 80
+      - https: 443
+    healthcheck:
+      url: tcp://192.168.2.2:80
+groups:
+  - g1: &g1
+    - <<: *anchornameforp1
+      weight: 1.0
+    - <<: *anchornameforp2
+      weight: 2.0
+  - g2: &g2
+    - <<: *anchornamefors1
+      weight: 0.6
+    - <<: *anchornamefors2
+      weight: 0.4
+
+##########
+## bar.yaml
+
+#
+# 
+#include foo.yaml
+# the 'include' line is replaced by the contents of ourhosts.yaml when this file, 'foo.yaml', is loaded
+#
+strategy:
+  policy: # Selection strategy policy: Enum of 'consistent_hash' or 'first_live' or 'rr_strict' or 'rr_ip' or 'latched'
+  hash_key: # optional key to use for Hashing. Enum of 'url' or 'uri' or 'hostname' or 'path' or 'path+query' or 'cache_key' or 'path+fragment'
+  groups:
+    - *g1
+    - *g2
+  protocol: https  # optional & enumerated. by default uses the remapped protocol
+  failover: # optional: defines the conditions to failover to a different server. This was "retries" in <= ATS 7
+    ring_mode: exhaust_ring # enumerated as exhaust_rings or alternate_rings
+      #1) in 'exhaust_ring' mode all the servers in a ring are exhausted before failing over to secondary ring
+      #2) in 'alternate_rings' mode causes the failover to another server in secondary ring.
+    response_codes: # defines the responses codes for failover in exhaust_rings mode
+      - 404
+      - 502
+    health_check: # specifies the list of healthchecks that should be considered for failover. A list of enums: 'passive' or 'active'
+      - passsive
+
+
+##########
+## foo.yaml
+(concatenate ourhosts.yaml and bar.yaml)