Added section about REST API

Author: artinnok

README.md

@@ -73,7 +73,6 @@ repos:
         name: black
         entry: black app
         language: python
-        exclude: models
         types: [python]
 
       - id: isort
@@ -147,6 +146,13 @@ from some.absolute.path import foo, bar
 Код читается намного больше, чем пишется. 
 
 
+## Документация к REST API
+Рекомендуемый формат документации - [OpenAPI](https://www.openapis.org).
+Схема для OpenAPI должна генерироваться "на лету", чтобы обеспечивать клиентов API свежими изменениями.
+
+**Почему?** Потому что это один из распространенных форматов для документирования REST API, которая вышла из Swagger. Данный формат документации поддерживается большим количеством клиентов (Swagger, Postman, Insomnia Designer и многие другие). Также, рукописная документация имеет свойство быстро устаревать, а документация, которая генерируется напрямую из кода позволяет не думать о постоянных обновлениях документации.
+
+
 ## Pull Request
 Дифф PR не должен превышать +/- 1000 строк.