ru.unix.bsd

 
 - RU.UNIX.BSD ------------------------------------------------------------------
 From : Valentin Nechayev                    2:5020/400     16 Dec 2004  14:13:05
 To : eugen@grosbein.pp.ru
 Subject : Re: VPN
 -------------------------------------------------------------------------------- 
 

 >>> Eugene Grosbein wrote: 
 
  EG>>> Этому не место в Howto (или, если угодно, это уже не Howto).
  EG>>> Этому место в книгах по предметной области и в документации на
  EG>>> конкретный софт.
  VN>> Книги по предметной области пропустим. А вот "документация на конкретный
  VN>> софт" - это уже показательно. HOWTO - не часть документации?;))
 EG> Дык не знаю, потому и интересуюсь.
 
 По-моему, этот вопрос был риторический. ;)
 Конечно же, если оно идёт в документации, то является её частью.
 
  VN>> OK, я согласен на то, что разделение несколько нелогично, но дело тут в
  VN>> том,
  VN>> что линуксовые howto составлялись часто в отрыве от конкретных продуктов,
  VN>> со ссылкой на целый комплект продуктов для одной цели.
  VN>> Точно тот же подход мы видим во фрёвом handbook'е: идёт сначала общее
  VN>> описание, что это такое и для чего его едят, а потом уже переход к
  VN>> конкретным реализациям (программы, конфиги и так далее).
 EG> Так то _book_.
 
 Предположим (хотя сомневаюсь, что в данном случае имел место явный акцент
 авторов на значение одной части слова - handbook уже давно стал цельным
 понятием). А что, принципиально запрещается держать в документации описание
 подобного типа? ;))
 
  VN>> И это правильно - не надо кормить документацией по особенностям ключей
  VN>> чего-то, пока непонятно, накойхер оно вообще нужно.
 EG> Угу.
 
 Во. Посему маны - сами по себе - представляют ценность почти нулевую.
 
  VN>> Чтобы стать FAQ, надо быть действительно часто наступаемой граблей.
  VN>> Для этого надо быть 1) граблей, 2) часто наступаемой;)
  VN>> Второе условие здесь скорее всего не выполняется.
 EG> Если это нечасто встречается, описано в основной доке по софтинке - то
 EG> зачем нужны сторонние HOWTO? Они приучают искать информацию в виде
 EG> таких готовых рецептов где угодно, но не в системной документации
 EG> и не прививают привычку изучать доку перед использованием (или хотя бы
 EG> в процессе). Исключение - HOWTO по имени Migration.txt, касающаяся
 EG> апгрейда.
 
 Опять ты про какое-то "приучают".
 Для начала их нужно прочитать. Понять, о чём речь. Без этого часто вообще
 невозможно понять, что строить и как. Hачальная теория может быть
 достаточно сложной.
 Выбрать по описанию, какой софт использовать и в каком режиме (программ
 может быть много, режимов тоже).
 И только после этого переходить к написанию настроек.
 
 А желающих сделать не думая будет всегда дофига. И от того, что они
 возьмут готовый пример из howto или у соседа, ничего не поменяется.
 Могут взять из архивов, когда кто-то приведёт свой рабочий конфиг
 (и результаты будут ещё хуже).
 Может, всё-таки не ругаться на howto, а делать их такими, чтобы действительно
 учили? А ещё лучше делать полную нормальную документацию.
 -netch-
 --- ifmail v.2.15dev5.3
  * Origin: Dark side of coredump (2:5020/400)
 
 

Вернуться к списку тем, сортированных по: возрастание даты  уменьшение даты  тема  автор