added embedding configuration documentation in schema JSON

CHANGELOG.md

 # v2.16.4
+
+* added embedding configuration documentation in schema JSON
+    * this functionality does not require updating satella

docs/configuration/schema.rst

@@ -173,3 +173,19 @@ In which case cast_to will be displayed as a
 which will be eval()ed, and this value will be
 output. The input value will be called **x**.
 
+You can also provide a commentary for your entries:
+
+.. code-block:: json
+
+
+    {
+        "contents": {
+            "type": "file_contents",
+            "encoding": "utf-8,
+            "description": "Encryption key (private key)
+        },
+        "max_workers": {
+            "type": "int",
+            "description": "Maximum parallel instances of service"
+        }
+    }

satella/__init__.py

-__version__ = '2.16.4a1'
+__version__ = '2.16.4a2'

tests/test_configuration/test_schema.py

@@ -93,7 +93,10 @@ class TestSchema(unittest.TestCase):
     def test_descriptor_from_schema(self):
         schema = {
             "key_s": "str",
-            "key_i": "int",
+            "key_i": {
+                "type": "int",
+                "description": "Value of key I"
+            },
             "key_f": "float",
             "ip_addr": "ipv4",
             "nested": {