LINUX.ORG.RU
ФорумTalks

Почему у самых крупных дистрибутивов самая бедная документация?

 , , ,


1

1

Сап, ЛОР. Решил узнать мнение общественности в лице ЛОРа, может я чего-то не понимаю ввиду своего ньюфажества, но почему у самых крупных дистрибутивов, являющихся столпами всего линукса - например Centos, Debian - самая бедная документация, имея ввиду вики? Стоит зайти на вики арча или генту - есть статья практически про любую софтину. Как установить, основные настройки, примеры. При этом даже для каких-либо популярных программ вроде того же Owncloud, OpenVPN для тех же CentOS и Debian находятся дай бог сайты хостеров вроде DigitalOcean, где есть инструкция по установке и конфигурированию, в худшем - миллион различных блогов мимоадминов, среди которых нужно еще найти рабочий, пока ещё актуальный вариант. Так вот, вопрос. ЧЯДНТ? Может реально я чего-то не понимаю, или не там ищу?

★★★★★

Последнее исправление: bsdfun (всего исправлений: 3)

Потому что в арче любят писать примеры, а в Debian — нет. Но по факту, проблема в авторах софта, которые не пишут годные доки.

kirk_johnson ★☆
()
Ответ на: комментарий от DELIRIUM

Иди обратно на двач.

Пофиксил для вашего спокойствия.

bsdfun ★★★★★
() автор топика
Ответ на: комментарий от kirk_johnson

Потому что в арче любят писать примеры, а в Debian — нет.

По идее комьюнити дебиана несоразмерно больше, чем у арча, но по факту в вики дебиана висят или какие-то огрызки, либо что-то протухшее, либо вообще ничего нет по нужному пакету.

bsdfun ★★★★★
() автор топика
Ответ на: комментарий от TheAnonymous

Тогда это замаскированный призыв сделать вдоль

goingUp ★★★★★
()

ТС, не ты один в недоумении.
Но.. времена документации на Солярис 10 канули в лету. Хотя и там воды налито было, при беглом осмотре.

Deleted
()
Ответ на: комментарий от kirk_johnson

Тогда афтары софта -неполноценные инженеры?
Раз не могут на свое поделие написать вменяемую и легко читаемую документацию... вспомнил советские инструкции к чему-нибудь и содрогнулся.

Deleted
()

У debian’а убогая документация, это да. Увы и ах. Видимо наполнять её некому, а бесплатно работать никто не хочет.

У CentOS документация совпадает с таковой у RHEL, поэтому они вообще не парятся. У Fedora документация более-менее в порядке.

У Arch Linux и Gentoo куча энтузиастов, которые любят пилить и ковырять, а после удачных экспериментов делиться инфой. Поэтому у них сильные и объёмные Wiki.

У Ubuntu тоже так себе доки.

EXL ★★★★★
()
Ответ на: комментарий от Deleted

Тогда афтары софта -неполноценные инженеры?
Раз не могут на свое поделие написать вменяемую и легко читаемую документацию...

А тут возникает такая проблема, что в разных дистрибутивах порой различные конфиги лежат в разных местах, разные системы инициализации и тд. Выходит, что разработчику нужно писать мануал для десяткая самых распространенных дистрибутивов.

bsdfun ★★★★★
() автор топика
Ответ на: комментарий от bsdfun

По идее комьюнити дебиана несоразмерно больше, чем у арча, но по факту в вики дебиана висят или какие-то огрызки, либо что-то протухшее, либо вообще ничего нет по нужному пакету.

Сообщество OpenBSD ещё меньше, чем у рача, а качество документации на порядок лучше.

kirk_johnson ★☆
()
Последнее исправление: kirk_johnson (всего исправлений: 1)
Ответ на: комментарий от te111011010

А альтернатива для аналогичного контента — только свой сайт.

Эти двое уж точно могут позволить себе запилить отдельный сайт.

bsdfun ★★★★★
() автор топика

например Centos

хорошо

Как установить,

yum install

основные настройки,

Открываешь в редакторе хорошо задокументированный конфиг и исправляешь

примеры.

Примеры чего?

imul ★★★★★
()
Ответ на: комментарий от Deleted

Раз не могут на свое поделие написать вменяемую и легко читаемую документацию... вспомнил советские инструкции к чему-нибудь и содрогнулся.

Ну вот, например: http://man.openbsd.org/smtpd.conf

Почитав гайд, можно запросто настроить себе SMTP сервак. Вот прям из коробки в дистрибутиве. Люблю их за это.

kirk_johnson ★☆
()
Последнее исправление: kirk_johnson (всего исправлений: 1)
Ответ на: комментарий от bsdfun

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

te111011010
()
Ответ на: комментарий от RazrFalcon

Что ещё должны авторы делать?

Доки писать, я же сказал. Ну то есть не обязаны, конечно, но зачем пользоваться софтом с корявой докой, если можно пользоваться софтом без корявой доки?

kirk_johnson ★☆
()

крупных дистрибутивов

документация

у gentoo отличная документация.

Deleted
()
Последнее исправление: Deleted (всего исправлений: 2)

Может реально я чего-то не понимаю, или не там ищу?

Не юзаешь мелких дистрибутивов, а то такой чуши бы не порол.

t184256 ★★★★★
()
Ответ на: комментарий от bsdfun

По идее комьюнити дебиана несоразмерно больше, чем у арча, но по факту в вики дебиана висят или какие-то огрызки, либо что-то протухшее, либо вообще ничего нет по нужному пакету.

Потому что сначала по грабельному полю прошел и набил шишки строй арчеводов, а к волне дебианщиков грабли либо остались протухшие, либо их не осталось совсем.

t184256 ★★★★★
()

Стоит зайти на вики арча или генту - есть статья практически про любую

Сообщество решает. Много энтузиастов участвует в написании Wiki на благо дистрибутива. Также AUR принадлежит сообществу дистрибутива, которое опакечивает различный софт и делится им (вообще непонятны претензии хейтеров Arch по поводу НЕОФИЦИАЛЬНОГО репозитория).

Debian - самая бедная документация

Сообщество Debian — админы, либо убунтята, либо озлобленные пердуны с sysvinit.

Deleted
()
Ответ на: комментарий от Deleted

Сообщество Debian — админы, либо убунтята, либо озлобленные пердуны с sysvinit.

Большинство, но не все, конечно.

Deleted
()

Сап, ЛОР

От того что ты «Суп» поменял на «Сап» лучше не стало.

Иди назад на двач.

reprimand ★★★★★
()

Обычно найдя решение проблемы для Убунты можно применять его на Дебиан

grim ★★☆☆
()

Ну документация именно по дистрибутиву в Debian прекрасна. А документация к по - это задача авторов самого по.

Polugnom ★★★★★
()
Последнее исправление: Polugnom (всего исправлений: 1)
Ответ на: комментарий от bsdfun

Ну вот, например, цитата из свежей оды в адрес NixOS:

Official documentation is awful. Or it is just absent. NixOS is older than Docker. They are solving the same task, but NixOS is way less popular. Try to think why.

Подтверждаю даже будучи фанатом.

t184256 ★★★★★
()

имея ввиду вики?

А зачем тебе вики? Просто в документации по проге чего не устраивает?

another ★★★★★
()

У арча документация отличная. Наилучшая, можно сказать.

pelmeshechka ★★
()

Стоит зайти на вики арча или генту - есть статья практически про любую софтину.

По-твоему, арч — не крупный?

pelmeshechka ★★
()

В Арче вовремя просекли, что формат вики в виде относительно коротких статей гораздо удобнее для простого пользователя, чем формат книги на десятки глав и разделов. Вики у «например Centos, Debian» пишутся по остаточному принципу, как я понимаю.

Thetan ★★★
()
Ответ на: комментарий от chenbr0

немудренно, у опенька пакетов то меньше

Дока на base. Пакеты это пакеты.

kirk_johnson ★☆
()
Вы не можете добавлять комментарии в эту тему. Тема перемещена в архив.