[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