Нормально ли делать инструкцию по установке ПО на 24 страницы?

Question

[Виталий Пухов]

Наткнулся на забавную статью на хабре, фактически это инструкция по установке "некого софта" на "типовой сервер", ради интереса скопировал "инструкцию" в Word и получил 24 страницы инструкций! То есть для того чтобы установить ПО нужно выполнить 24 страницы инструкции?!
И это не какая ни будь монструозная CRM с десятками интеграций, это всего навсего 1 веб приложение.
ИМХО это ненормально и такой продукт вообще не стоит пускать в релиз, все что там из "реально нужного" это 3 страницы с "основными конфигурациями" остальное просто борьба с багами и накладывание костылей поверх других костылей.
P.S. статья заканчивается словами "На этом все, OTRS готова для дальнейшей настройки.", что как бы намекает, что те 24 страницы это только начало...
Мне интересно, это лишь мое мнение или другие тоже так считают? Как по вашему должна выглядеть "установка ПО".

Answer 1

[Сергей]

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

Comments

[Виталий Пухов]

я как раз об это и говорю, ПО не должно предъявлять требаний к частям тела, если человек, который ее устанавливает не знает как это сделать не значит, что он не сможет им пользоваться из чего и делаю вывод, что ПО должно устанавливаться без необходимости править 100500 конфигурационных файлов чтобы получить "типовую" конфигурацию.

[Сергей]

боюсь тут вы заблуждаетесь. есть разного уровня ПО. и я сомневаюсь что вам как не специалисту получится развернуть виртуализацию на solaris без поседения. я уж не говорю про то чтоб она корректно работала. в области администрирования есть четкие требования по багажу знаний ... если у вас их нету. то вам явно не по пути с этим ПО.

[Сергей]

docs.oracle.com/cd/E36784_01/index.html почти 600 метров щастья дабы вкусить данный плод.

[Сергей]

а вы говорите 24 страницы =D

[Виталий Пухов]

Сергей: не отрицаю, есть ПО, которое требует тонкой настройки и подходящих условий для правильного функционирования, но этим ПО никак не может быть простое веб приложение, которое максимум что пользуется mysql. Я имею в виду к примеру такое как в статье :
0. Подготавливаем среду (мускуль, апач и т.п.)
1. Запускаем установку
2. Ловим багу
3. Чиним багу
4. Ловим багу
5. Чиним багу
...
N. Profit!
Я считаю пунктов 2-N-1 быть не должно.

[Виталий Пухов]

Сергей: Oracle это да, они любят заморочки там где и без них можно обойтись:)

[DevMan]

Виталий Пухов: а вы хотели без багов на неподдерживаемой платформе?

[Виталий Пухов]

DevMan: Вы правы, как то не обратил на это внимание в статье, тогда можно понять конечно.

Answer 2

[DevMan]

там описана установка не только самого OTRS, а поднятие всего сервера (апач, мускуль, перл), да еще и со скриншотами.
да еще и под винду (на никсах это либо уже есть в системе, либо ставится одной командой).

Comments

[Виталий Пухов]

видимо я чтото не так сформулировал, к примеру bitnami, там можно скачать пакет и развернуть все вышеперечисленное с 2 кнопок - "Далее" и "Установить". Максимум пароли к mysql вбить еще. Я имел в виду в вопросе почему производитель выпускает продукт, который нельзя поставить "из коробки" без правки конфигов и т.п.

[DevMan]

Виталий Пухов: потому что битнами не делает софт сам - он делает безменингитные сборки и это их работа.
инструкция по установке otrs на линукс (а винду они не супортают и не рекомендуют) занимает 4 неплотных страницы, половина из которых занята скриншотами.

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

Answer 3

[Alex XYZ]

Я за такие инструкции! Пофигу, что под винду. Под linux должно быть не меньше. Пройдёт пару недель и ничего не вспомнить уже.

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

У меня самого есть одна инструкция, как я делал для серверов под linux/windows выход в инет через внутренний прокси, с помощью сntlm, а "кранчиком" был fiddler (обновления скачать, git-clone, grunt, bower и т.д.). Так полотно ещё больше получилось:



Мой вывод - я за такие инструкции и поддерживаю людей, которые не ленятся писать такое.

Comments

[DevMan]

под линукс 4 страницы, половину из которых занимают скриншоты.

[Alex XYZ]

Можно, конечно и меньше, но, подумайте, что вы даёте такую инструкцию другому человеку поэтому тут избыточность может быть полезна. Т.к. не у всех совпадает мнение относительно длинных "цепочек".

[DevMan]

Захаров Александр: я о том что инструкция по установке не должна быть большой.
а вот всякие "готовые рецепты" и прочие how to - чем больше, тем лучше.

[Alex XYZ]

DevMan: Ну тут дело привычки. Понимаю, что прочитав эту инструкцию, вы для себя её, конечно, сократите, но если другой человек первый раз видит эту систему, даже если знает все компоненты, то будут вопросы. Для нормальной работы система должна быть хорошо документирована и изменения в ней должны быть залогированы хотя бы словами. Трудно рассуждать на тему хороша ли или плоха из-за длины и распространённости отдельно взятая инструкция. По-идее хорошо бы был в конторе человек, который принимает или нет такие инструкции к употреблению, но если эта инструкция помогает получить результат, не задавая вопросов разработчику - то это отличная инструкция. Я, конечно, несколько отклонился от основной темы )

[DevMan]

Захаров Александр: я всего лишь о том, что названное автором "инструкцией по установке" таковой не является ))

Answer 4

[Antony]

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

К тому же если там, например, добавить установки под разными ОС, да еще и под разные серверы и т.п. да еще и с обилием скриншотов - там может получиться не одна сотня страниц. (

Answer 5

[Takoe-Kakoe]

Автор вопроса, вы не правы ). Есть разные уровни умений. Кому-то все понятно без инструкции, но это не значить, что она не понадобиться новичками или менее продвинутым. К примеру я, к примеру, еще не знаю, что такое OTRS, Apache т.д. а MySqL - для меня лишь знакомое слово, но по такой инструкции, я могу сделать всё правильно.
И поначалу только благодаря подобным инструкциям мне не раз удавалось удалять всякие рабмлертабы, мейлру_поиски и прочие порно-информеры с компов нерадивых друзей и коллег.
А создателю статьи нужно сказать громадное спасибо за труд, т.к я не понаслышке знаю, как утомительно составлять инструкции со скриншотами даже на пару страниц. А тут целых 24.

Answer 6

[Кукушкин Иван]

нет