Fixed indentation. Comments and notes added.

docs/docsite/helper/lists_mergeby/default-common.yml

@@ -5,6 +5,7 @@ list1:
     extra: false
   - name: meh
     extra: true
+
 list2:
   - name: foo
     path: /foo

docs/docsite/helper/lists_mergeby/list3.out.j2

@@ -1,2 +1,2 @@
 list3:
-  {{ list3|to_nice_yaml|indent(2) }}
+{{ list3|to_nice_yaml(indent=0) }}

docs/docsite/helper/lists_mergeby/playbook.yml

@@ -1,15 +1,25 @@
 ---
+
 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 # 1) Run all examples and create example-XXX.out
 # shell> ansible-playbook playbook.yml -e examples=true
 #
-# 2) Optionally, create examples_all.rst
+# 2) Optionally, for testing, create examples_all.rst
 # shell> ansible-playbook playbook.yml -e examples_all=true
 #
-# 3) Create other REST files. See the blocks below.
+# 3) Create docs REST files
 # shell> ansible-playbook playbook.yml -e merging_lists_of_dictionaries=true
+#
+# Notes:
+# * Use YAML callback, e.g. set ANSIBLE_STDOUT_CALLBACK=community.general.yaml
+# * Use sphinx-view to render and review the REST files
+#   shell> sphinx-view <path_to_helper>/examples_all.rst
+# * Proofread and copy completed docs *.rst files into the directory rst.
+# * Then delete the *.rst and *.out files from this directory. Do not
+#   add *.rst and *.out in this directory to the version control.
+#
 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-# docs/docsite/helper/lists_mergeby/playbook.yml
+# community.general/docs/docsite/helper/lists_mergeby/playbook.yml
 
 - hosts: localhost
   gather_facts: false

docs/docsite/rst/filter_guide_abstract_informations_merging_lists_of_dictionaries.rst

@@ -16,6 +16,7 @@ Let us use the lists below in the following examples
       extra: false
     - name: meh
       extra: true
+
   list2:
     - name: foo
       path: /foo