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

[Leonid Krivoshein]

19.11.2020 18:51, Anton Farygin пишет:
> On 19.11.2020 16:46, Dmitry V. Levin wrote:
>> On Thu, Nov 19, 2020 at 04:34:17PM +0300, Anton Farygin wrote:
>>> On 19.11.2020 16:23, Dmitry V. Levin wrote:
>> [...]
>>>> По-хорошему запаковать бы этот /usr/share/doc/flac/api/ в отдельный
>>>> подпакет libflac-devel-doc, поскольку для сборки с -lflac документация
>>>> по API совершенно ни к чему.
>>>>
>>>>
>>> да выкинуть документацию из пакета, кому она нужна в эпоху интернета ?
>> Хороший вопрос, на самом деле, нужно ли паковать документацию,
>> если она есть в интернете.
>>
>> Можно поставить вопрос ещё шире:
>> нужно ли паковать что-то в Сизиф, если оно есть в интернете?
>>
>> Например, зачем паковать 100500 модулей языка $language, если они всё
>> равно по большей части получаются протухшие в репозитории, и на практике
>> проще сделать $language_module_install_tool install $module?
>>
>> Может быть, я немного утрирую, но лишь совсем немного.
>
> вопрос в нужности этой документации. т.е. - если бы ей кто-то 
> пользовался, то да, конечно надо паковать.
>

Есть люди, которые ей пользуются. И вариант, что "мы это описали на 
ВиКи" не катит. Жаль, таких людей очень мало.


> а если ей никто не пользуется - то зачем ?

Если пользуется не много людей, в инсталляторе должен быть флажок 
"Документация" (он у нас есть, но про другое) в изначально очищенном 
состоянии. А пакеты с документацией в репозитории и на установочном 
диске нужны, ставить их или нет -- решает админ, паковать в тот же пакет 
или в *-doc -- меинтейнер, в случае библиотек/API это разумно отделять, 
я считаю.


-- 
Best regards,
Leonid Krivoshein.