Добавлен раздел с факапами при публикации пакетов

Author: dx3mod

docs/recipes/publish-package.md

@@ -2,6 +2,8 @@
 
 Центральный репозиторий пакетов для OCaml называется [opam-repository](https://github.com/ocaml/opam-repository) и является GitHub-репозиторием, содержащий файлы манифестов.
 
+## Публикация
+
 Чтобы опубликовать ваш проект в opam-репозитории и сделать его общедоступным вам потребуется:
 
 1. Во-первых манифест проекта, файл [`<название-проекта>.opam`](https://opam.ocaml.org/doc/Packaging.html#Creating-a-package-definition-file). Самый простой и современный способ его получить &mdash; использовать [Dune](../tools/dune.md);
@@ -73,4 +75,33 @@ $ opam publish
 ### Принятие
 
 После того как вы исправите все свои косяки, ваш PR сольют с репозиторием и вы сможете установить
-пакет обычным `opam install`.
+пакет обычным `opam install`.
+
+## Факапы
+
+:::details revdeps
+
+Ошибка при сборки обратных зависимостей.
+
+> [!NOTE] Пример
+> ![](https://i.ibb.co/yBm59wy/image.png)
+
+> [!INFO] Причина
+> Скорее всего вы сломали API библиотеки, а предыдущие версия в зависимостях имела открытый ограничитель.
+> Например, вы добавляете версию `0.3` вашей библиотеки, где существенно изменили API, а библиотека версии `0.2` имеет зависимость `(lib (>= 0.2))` (открытый ограничитель). В результате чего и падает сборка, так как пытается собрать старый пакет с новой версией библиотеки.
+
+> [!IMPORTANT] Решение
+> Измените ограничитель прошлых версией библиотек. [Пример](https://github.com/ocaml/opam-repository/pull/26624/files). Для этого придётся ручками править файлы в репозитории, либо воспользоваться `opam admin add-constraint`.
+
+:::
+
+:::details conf-pkg-config.3 failed to build
+
+> [!NOTE] Пример
+> ![](https://i.ibb.co/9cRQNS6/image.png)
+
+> [!IMPORTANT] Решение
+> Ждите вмешательство ментейнера, это не ваша ошибка. 
+
+:::
+