[devel] кому нужна документация в эпоху интернета

Mikhail Novosyolov mikhailnov на altlinux.org
Чт Ноя 19 19:35:18 MSK 2020


19.11.2020 19:23, Alexey V. Vissarionov пишет:
> On 2020-11-19 19:10:30 +0300, Vladimir D. Seleznev wrote:
>
>  >>>> Может быть, я немного утрирую, но лишь совсем немного.
>  >>> вопрос в нужности этой документации. т.е. - если бы ей кто-то
>  >>> пользовался, то да, конечно надо паковать.
>  >>> а если ей никто не пользуется - то зачем ?
>  >> Документацию нужно держать в %package doc - когда она нужна, ее
>  >> читают не там, где работает основной пакет. А там, где работает
>  >> основной пакет, она в 99.9% случаев не нужна.
>  > Я от себя ещё добавлю, что разработческую документацию стоит
>  > таки держать в %name-devel-doc, а не в %name-devel.
>
> Разумеется. И в %name-doc ей тоже не место: админы и разработчики
> в норме читают разную документацию.
>
> Еще, кстати, полезно %name-man в отдельные пакеты выносить, а в
> основном пакете писать Requires: %name-man
>
> Просто потому, что есть существенное количество админов, которые
> предпочитают держать на боевом ноутбуке полную коллекцию нужной
> документации. Даже если описываемое в ней используется где-то еще
> (вне боевого ноутбука; возможно, даже на другой архитектуре).
RPM умеет исключать помеченные как %doc файлы при установке пакетов, проще научить его делать наоборот и ставить только %doc'и.


Подробная информация о списке рассылки Devel