with a few more comments

examples/service/ruddle.yaml

@@ -1,5 +1,8 @@
+# Only 1 inheritance allowed (no multiple inheritance)
+# The script will inherit all base settings, such as version, plugins and so on.
 basedOn: ../base/ruddle.base.yaml # can also be git repo with ruddle.yaml in root
 
+# inputs are set to fill out details of scripts provided from children
 input:
   org:
     name: "some-name"