Edit README.md

README.md

@@ -4,4 +4,44 @@
 компонентов Calista.
 
 В этом репозитории существует два файла - README.md, то есть этот файл, а также файл components.json, который описывает
-доступные компоненты, их версии, зависимости и ссылки на репозитории этих компонентов.
+доступные компоненты, их версии, зависимости и ссылки на репозитории этих компонентов.
+
+Формат файла components.json
+
+```
+json
+
+{
+  "version": "v1",
+  "components": [
+    {
+      "id": "уникальный-идентификатор",
+      "name": "Человекочитаемое название",
+      "desc": "Описание",
+      "repo": "ссылка на git-репозиторий",
+      "latest": "тег-последней-версии",
+      "requires": ["зависимости"],
+      "tags": {
+        "тег-версии": "короткий-хэш-коммита"
+      }
+    }
+  ]
+}
+
+```
+
+Описание ключей
+
+- version - Версия спецификации описания файла components.json - обязательный
+- components - Массив объектов описания компонентов (далее component) - обязательный
+- component->id - Идентификатор компонента, без пробелов - обязательный
+- component->name - Имя компонента - обязательный
+- component->desc - Описание компонента - необязательный
+- component->repo - Ссылка на git репозиторий - обязательный
+- component->latest - Тег последней версии - обязательный
+- component->requires - Массив идентификаторов зависимых компонентов с указанием версии в формате "имя компонента:версия" - необязательный
+- component->tags - Объект указывающий на коммиты версий компонентов - обязательный
+- component->tags->тег-версии - Короткий кеш коммита - обязательный для тега latest, остальные не обязательны
+
+По необходимости ключи могут дополняться, но в данный момент я вижу что этих ключей хватит надолго
+