Neuroware
@Neuroware
Программист в свободное от работы время

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

Наткнулся на забавную статью на хабре, фактически это инструкция по установке "некого софта" на "типовой сервер", ради интереса скопировал "инструкцию" в Word и получил 24 страницы инструкций! То есть для того чтобы установить ПО нужно выполнить 24 страницы инструкции?!
И это не какая ни будь монструозная CRM с десятками интеграций, это всего навсего 1 веб приложение.
ИМХО это ненормально и такой продукт вообще не стоит пускать в релиз, все что там из "реально нужного" это 3 страницы с "основными конфигурациями" остальное просто борьба с багами и накладывание костылей поверх других костылей.
P.S. статья заканчивается словами "На этом все, OTRS готова для дальнейшей настройки.", что как бы намекает, что те 24 страницы это только начало...
Мне интересно, это лишь мое мнение или другие тоже так считают? Как по вашему должна выглядеть "установка ПО".
  • Вопрос задан
  • 807 просмотров
Решения вопроса 5
edinorog
@edinorog
Троллей не кормить!
не хочу обидеть вопрошающего, но вся эта инструкция состоит из "вам нужны прямые руки". если у вас нет прямых рук, то вам не только инструкция на 24 страницы нужна, но и еще пару учебников по сетевому делу и операционным системам понадобятся.
Ответ написан
DevMan
@DevMan
там описана установка не только самого OTRS, а поднятие всего сервера (апач, мускуль, перл), да еще и со скриншотами.
да еще и под винду (на никсах это либо уже есть в системе, либо ставится одной командой).
Ответ написан
AlexXYZ
@AlexXYZ
O Keep Clear O
Я за такие инструкции! Пофигу, что под винду. Под linux должно быть не меньше. Пройдёт пару недель и ничего не вспомнить уже.

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

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

7fc079e1312f47cdbc2b6e2b7114a99f.png

Мой вывод - я за такие инструкции и поддерживаю людей, которые не ленятся писать такое.
Ответ написан
RiseOfDeath
@RiseOfDeath
Диванный эксперт.
А что такого? Видеале инструкция должна содержать указния на все хоть сколько-нибудь возможные случаи.

К тому же если там, например, добавить установки под разными ОС, да еще и под разные серверы и т.п. да еще и с обилием скриншотов - там может получиться не одна сотня страниц. (
Ответ написан
Комментировать
@Takoe-Kakoe
Автор вопроса, вы не правы ). Есть разные уровни умений. Кому-то все понятно без инструкции, но это не значить, что она не понадобиться новичками или менее продвинутым. К примеру я, к примеру, еще не знаю, что такое OTRS, Apache т.д. а MySqL - для меня лишь знакомое слово, но по такой инструкции, я могу сделать всё правильно.
И поначалу только благодаря подобным инструкциям мне не раз удавалось удалять всякие рабмлертабы, мейлру_поиски и прочие порно-информеры с компов нерадивых друзей и коллег.
А создателю статьи нужно сказать громадное спасибо за труд, т.к я не понаслышке знаю, как утомительно составлять инструкции со скриншотами даже на пару страниц. А тут целых 24.
Ответ написан
Комментировать
Пригласить эксперта
Ответы на вопрос 1
@deleted-webter
О себе вот тут такой рассказ. Бит среди терабайтов
нет
Ответ написан
Комментировать
Ваш ответ на вопрос

Войдите, чтобы написать ответ

Войти через центр авторизации
Похожие вопросы