ru.unix.bsd

 
 - RU.UNIX.BSD ------------------------------------------------------------------
 From : Eugene Grosbein                      2:5006/1       16 Dec 2004  11:36:40
 To : Valentin Nechayev
 Subject : Re: VPN
 -------------------------------------------------------------------------------- 
 

 16 дек 2004, четверг, в 00:46 KRAST, Valentin Nechayev написал(а):
 
  VN>>>  - Описание понятий, используемых в той или иной области, включая
  VN>>>  определения,
  VN>>>    граничные признаки, бытовые примеры и точные формулировки.
  EG>> Этому не место в Howto (или, если угодно, это уже не Howto).
  EG>> Этому место в книгах по предметной области и в документации на
  EG>> конкретный софт.
  VN> Книги по предметной области пропустим. А вот "документация на конкретный
  VN> софт" - это уже показательно. HOWTO - не часть документации?;))
 
 Дык не знаю, потому и интересуюсь.
 
  VN> OK, я согласен на то, что разделение несколько нелогично, но дело тут в
  VN> том,
  VN> что линуксовые howto составлялись часто в отрыве от конкретных продуктов,
  VN> со ссылкой на целый комплект продуктов для одной цели.
  VN> Точно тот же подход мы видим во фрёвом handbook'е: идёт сначала общее
  VN> описание, что это такое и для чего его едят, а потом уже переход к
  VN> конкретным реализациям (программы, конфиги и так далее).
 
 Так то _book_.
 
  VN> И это правильно - не надо кормить документацией по особенностям ключей
  VN> чего-то, пока непонятно, накойхер оно вообще нужно.
 
 Угу.
 
  VN>>> В частности, для конфигов это может
  VN>>>    выглядеть как "если вам нужно XXX, скажите option xxx. Если Вам нужно
  VN>>>    YYY,
  VN>>>    скажите option yyy, но если написано option ttt, это даст совершенно
  VN>>>    неожиданный эффект - YYY превратится в ZZZAAA".
  EG>> FAQ? В качестве дополнения к тому же самому, изложенному в доке.
  EG>> По сути, донесение (чаще потребной) информации в другой форме.
  VN> Чтобы стать FAQ, надо быть действительно часто наступаемой граблей.
  VN> Для этого надо быть 1) граблей, 2) часто наступаемой;)
  VN> Второе условие здесь скорее всего не выполняется.
 
 Если это нечасто встречается, описано в основной доке по софтинке - то
 зачем нужны сторонние HOWTO? Они приучают искать информацию в виде
 таких готовых рецептов где угодно, но не в системной документации
 и не прививают привычку изучать доку перед использованием (или хотя бы
 в процессе). Исключение - HOWTO по имени Migration.txt, касающаяся
 апгрейда.
 
  VN> Hу и к тому же держать в FAQ то, чего нет в других местах документации
  VN> (не в смысле "описано другими словами", а в смысле "нет вообще") - очень
  VN> плохой метод построения документации. Так нельзя.
 
 Угу.
 
 Eugene
 --- slrn/0.9.8.0 (FreeBSD)
  * Origin: Svyaz Service JSC (2:5006/1@fidonet)
 
 

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