TASK: Bring back comments and new lines for readability

Author: kdambekalns

Configuration/Settings.yaml

@@ -2,9 +2,18 @@
 Neos:
   ContentRepository:
     Search:
+      # API. If set to FALSE, only index the "live" workspace and not user workspaces.
+      # If you only index the live workspace, Search will not work for your editors in the user workspaces.
+      # Furthermore, if you heavily rely on Search for collecting content, this might be strange for editors to
+      # work with -- as unpublished changes are not indexed right away.
       indexAllWorkspaces: true
+
       elasticSearch:
+
+        # API. name of the ElasticSearch index to use. Will create many indices prefixed by this indexName.
         indexName: typo3cr
+
+        # configuration of the ElasticSearch logfile
         log:
           backendOptions:
             fileBackend:
@@ -14,34 +23,45 @@ Neos:
               maximumLogFileSize: 10485760
               logFilesToKeep: 1
               logMessageOrigin: false
+
             ansiConsoleBackend:
               disableAnsi: false
+
       defaultConfigurationPerType:
+
         string:
           elasticSearchMapping:
             type: string
             include_in_all: false
+
         boolean:
           elasticSearchMapping:
             type: boolean
+
         integer:
           elasticSearchMapping:
             type: integer
+
         DateTime:
           elasticSearchMapping:
             type: date
             format: date_time_no_millis
             include_in_all: false
+
         Neos\Media\Domain\Model\Asset:
-          elasticSearchMapping: ''
+          elasticSearchMapping: '' # deliberately don't map or index this
+
         array<Neos\Media\Domain\Model\Asset>:
-          elasticSearchMapping: ''
+          elasticSearchMapping: '' # deliberately don't map or index this
+
         Neos\Media\Domain\Model\ImageInterface:
-          elasticSearchMapping: ''
+          elasticSearchMapping: '' # deliberately don't map or index this
+
         references:
           elasticSearchMapping:
-            type: string
+            type: string # an array of strings, to be precise
             index: not_analyzed
+
         reference:
           elasticSearchMapping:
             type: string