2 major aims

Mention YAML as bootstrap format
Since YAML with "Provide JCR bootstraps as YAML (too)" - YAML no longer limited to use for definition items only. This must be reflected on the YAML page.
E.g. adapt the section "YAML in the context of Magnolia"

Add more sophisticated examples ...
.. for YAML as item definition language.

The page just covers the very basic.
Let's add a few more sophisticated things, such as:

• Reusing existing maps when defining a new one using >>
  • here we may also mention the down sides which may appear when decorating
• etc. pp

Check links, etc.