upd README + docs

README.md

@@ -2,13 +2,23 @@
 
 Возможно `DDNS` клиент
 
-## запуск
+## Запуск
 
 ~~~sh
 python -m pddnsc.cli
 ~~~
 
-## конфигурация
+либо в [docker](https://www.docker.com)/[podman](https://podman.io) (для запуска по расписанию в `cron`):
+
+~~~bash
+docker build -t my/pddnsc .
+docker run -v .state:/app/state:rw \
+           -v .settings:/app/settings:ro \
+           -e SCHEDULE=@hourly \
+           my/pddnsc
+~~~
+
+## Конфигурация
 
 Конфигурация находится в файле `settings/config.toml`.
 Пример конфигурации:
@@ -52,6 +62,20 @@ python -m pddnsc.cli
 
 Все модули источников/фильтров/вывода работают конкурентно через `asyncio`.
 
-### TODO
+### Подробная документация
 
-- Добавить названия python классов и их параметры.
+Её необходимо собрать с помошью [mkdocs](https://www.mkdocs.org). Для этого нужно установить зависимости:
+
+~~~bash
+pip install -r requirements.txt
+pip install -r requirements.docs.txt
+~~~
+
+После этого либо собрать документацию в каталог `site/`, либо запустить тестовый сервер.
+
+~~~bash
+# сборка
+mkdocs build
+# тестовый сервер
+mkdocs serve
+~~~

mkdocs.yml

@@ -20,5 +20,5 @@ plugins:
       config: mkapi_conf.py
 
 nav:
-  - Home: index.md
+  - Главная: index.md
-  - Reference: $api/pddnsc.***
+  - Справочник: $api/pddnsc.***