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

Alexey V. Vissarionov gremlin на altlinux.org
Чт Ноя 19 19:23:42 MSK 2020


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

Просто потому, что есть существенное количество админов, которые
предпочитают держать на боевом ноутбуке полную коллекцию нужной
документации. Даже если описываемое в ней используется где-то еще
(вне боевого ноутбука; возможно, даже на другой архитектуре).


-- 
Alexey V. Vissarionov
gremlin ПРИ altlinux ТЧК org; +vii-cmiii-ccxxix-lxxix-xlii
GPG: 0D92F19E1C0DC36E27F61A29CD17E2B43D879005 @ hkp://keys.gnupg.net


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