Добавлено больше howto в статью про Dune

Author: dx3mod

docs/public/memes/how-to-build-release.png

@@ -2,44 +2,47 @@
 
 **Dune** - самое популярное решение для сборки OCaml-проектов, оно глубоко интегрировано в экосистему языка, обладает современным функционалом (на подобие инкрементальной сборки, параллельности) и позволяет собирать как исполняемые программы, так и библиотеки, вызывать тесты.
 
-- [Quick start](https://dune.readthedocs.io/en/stable/quick-start.html)
+> [!NOTE] Документация
+>
+> - [Официальный сайт проекта](https://dune.build)
+> - Стартовый туториал [Quick start](https://dune.readthedocs.io/en/stable/quick-start.html)
 
-Стоит понимать, Dune не занимается управлением пакетами (сторонних библиотек), она способна только их подключать.
-Для управления же используется пакетный менеджер [OPAM](./opam.md).
+> [!IMPORTANT] Управление зависимостями
+> Стоит понимать, Dune не занимается управлением пакетами (зависимостями).
+> Для этого используется пакетный менеджер [OPAM](./opam.md).
 
 ## Базовые понятия
 
-Проекты Dune состоят из компонентов. Компонент может быть
+Разработка происходит в рамках **проекта**, корень проекта определяется по файлу `dune-project`. Проект в свою очередь состоит из **компонентов**.
 
-- **Исполняемым** (executable)
-- **Библиотечным** (library)
-- **Тестом** (test)
+| Компонент  | Описание                                   | dune              |
+| ---------- | ------------------------------------------ | ----------------- |
+| Executable | Содержит непосредственно исполняемый код   | `(executable ..)` |
+| Library    | Код для использования другими компонентами | `(library ..)`    |
+| Test       | Содержит тесты для компонентов             | `(test ..)`       |
 
-Проект содержит один или более компонент любого типа, которые могут зависеть друг от друга.
+### Компоненты
 
-Эти компоненты могут быть объеденины в пакеты для их последующего распространения.
+У компонента всегда есть имя (строфа `name`) по которому можно обращаться **внутри** проекта.
+Если вы хотите сделать компонент публичным, то вы должны дать ему публичное имя (строфа `public_name`) и указать в качестве пакета в `dune-project` (если требуется).
 
-## Автоматическое форматирование
-
-Для этого у вас должен быть установлен [`ocamlformat`](https://github.com/ocaml-ppx/ocamlformat).
+> [!TIP] Зависимости между компонентами
+> Если ваши компоненты зависят друг от друга, то явно указывайте к какому пакету они относятся.
+> В противном случае Dune будет выдавать ошибку с просьбой сделать подключаемый компонент публичным
+> при попытки подключить приватный библиотечный компонент к публичному библиотечному.
 
-```sh
-$ opam install ocamlformat
-```
+> [!TIP] Публичные имена
+> Публичные имена могут содержать символ `-`, что является предпочтительным разделителем слов в названиях пакетов. Пример:
+>
+> ```dune
+> (library
+>   (name cool_unix)
+>   (public_name cool-unix))
+> ```
 
-После чего в корень проекта добавьте файл `.ocamlformat`:
-
-```sh
-$ touch .ocamlformat
-```
-
-Этого достаточно, чтобы использовалось автоформатирование командами:
-
-```sh
-$ dune fmt # или dune build @fmt
-```
+## Автоматическое форматирование
 
-Для настройки профиля и версии смотрите [документацию](https://dune.readthedocs.io/en/stable/howto/formatting.html).
+Смотрите статью про форматтер [ocamlformat](./ocamlformat.md).
 
 ## Чтения файлов в тестах
 
@@ -110,3 +113,30 @@ Dune умеет в установку скомпилированных арте
 > (package) stanzas do not support all opam fields or complete syntax for dependency specifications. If the package you are adapting requires this, keep the corresponding opam fields in a pkg.opam.template file. See [Packages](https://dune.readthedocs.io/en/stable/reference/packages.html).
 
 Смотрите пример использования: [переопределение](https://github.com/mattjbray/ocaml-decoders/blob/master/decoders-msgpck.opam.template), [новые поля](https://github.com/dx3mod/repostbot/blob/master/repostbot.opam.template).
+
+## Интеграция с LSP
+
+Реализация языкового сервера OCaml использует генерируемые при сборки Dune'ой файлы для своей работы.
+Это можно заметить при создания нового файла, который редактор будет помечать красным с просьбой обновить кеш (то есть собрать проект для получения необходимой информации о новом файле).
+
+Поэтому для повышения отзывчивости вы можете воспользоваться командой
+
+```sh
+$ dune build @check -w
+```
+
+## Release-сборка проекта
+
+Можно так, но он вообще работает?
+
+```sh
+$ dune build --profile release
+# или
+$ dune build release
+```
+
+::: details Мем
+
+![](../public/memes/how-to-build-release.png)
+
+:::

docs/tools/dune.md

@@ -1,27 +1,29 @@
 # ocamlformat
 
-[ocamlformat] — инструмент для автоматического форматирование исходного кода на языке OCaml, 
-является частью [OCaml Platform](https://ocaml.org/platform). Имеет гибкую конфигурацию и профили, 
-умеет форматировать комментарии. 
+[ocamlformat] — инструмент для автоматического форматирование исходного кода на языке OCaml,
+является частью [OCaml Platform](https://ocaml.org/platform). Имеет гибкую конфигурацию и профили,
+умеет форматировать комментарии.
 
 ## В Dune-проекте
 
 Для использования форматтера в Dune-проекте необходимо в корне проекта создать файл `.ocamlformat`. Его можно оставить пустым и тогда применяться настройки по умолчанию.
 
-Для вызова форматтера можно использовать команды:
+Для вызова форматтера используйте команды:
+
 ```sh
 $ dune fmt
 # или
 $ dune build @fmt
+# watch-режим форматирования
+$ dune fmt -w
 ```
 
 Документация: [How to Set up Automatic Formatting](https://dune.readthedocs.io/en/stable/howto/formatting.html).
 
-## Вне проекта 
+## Вне проекта
 
 ```sh
 $ ocamlformat --enable-outside-detected-project -i *.ml
 ```
 
-
-[ocamlformat]: https://github.com/ocaml-ppx/ocamlformat
+[ocamlformat]: https://github.com/ocaml-ppx/ocamlformat