Update README

Author: aleksip

README.md

@@ -2,7 +2,7 @@
 
 ## Installation
 
-To install the plugin run:
+To install and use the plugin run:
 
 ```sh
 composer require aleksip/plugin-data-transform
@@ -11,10 +11,17 @@ composer require aleksip/plugin-data-transform
 
 ## Features
 
-Currently the plugin provides 3 transform functions for the JSON data read by Pattern Lab.
+### Pattern-specific data file support for included patterns
 
+Pattern Lab currently only supports global data files and a pattern-specific data file for the main pattern. This plugin adds pattern-specific data file support for included patterns. This feature only works with Twig PatternEngine.
 
-### Include pattern files
+
+### Data transform functions
+
+Currently the plugin provides 3 transform functions for the data read by Pattern Lab. The examples provided are in JSON but Pattern Lab supports YAML too! These functions should work with both Twig and Mustache PatternEngines.
+
+
+#### Include pattern files
 
 If a value contains the name of a pattern in shorthand partials syntax, the plugin will replace the value with the rendered pattern:
 
@@ -43,7 +50,7 @@ Advanced syntax with support for passing variables and disabling access to the d
 In both examples the value of `key` will replaced with the rendered pattern.
 
 
-### Join text values
+#### Join text values
 
 ```json
 {
@@ -62,16 +69,16 @@ In both examples the value of `key` will replaced with the rendered pattern.
 The value of `key` will be replaced with the joined strings. Note that in the example `molecules-comment.html` is the name of a pattern in shorthand partials syntax. These will be replaced with the rendered pattern before the join.
 
 
-### Create Drupal `Attribute` objects
+#### Create Drupal `Attribute` objects
 
 ```json
 {
     "key": {
         "Attribute()": {
-            "id": [ "edit-submit" ],
-            "type": [ "submit" ],
-            "value": [ "Submit" ],
-            "class": [ "button", "button-primary" ]
+            "id": ["edit-submit"],
+            "type": ["submit"],
+            "value": ["Submit"],
+            "class": ["button", "button-primary"]
         }
     }
 }
@@ -82,4 +89,4 @@ The value of `key` will be replaced with an [Attribute object](https://www.drupa
 
 ## More examples
 
-All functions provided by this plugin are used extensively in [Shila Drupal Theme StarterKit](https://github.com/aleksip/starterkit-shila-drupal-theme).
+All features provided by this plugin are used extensively in [Shila Drupal Theme StarterKit](https://github.com/aleksip/starterkit-shila-drupal-theme).