[docs] Re: wiki

[Alexandre Prokoudine]

On Mon, 25 Nov 2002 11:17:15 +0300
Vitaly Ostanin <vyt на vzljot.ru> wrote:

> В названии можно было бы честно написать, что это FAQ :)

Пока - да. Но не FAQ является целью

> Вопросы не пронумерованы, неудобно ссылаться. 

Тоже временно. Спасибо за подсказку

> в ответе из 3-й пары непонятно, зачем нужен 4-й шаг (с iconv).

То есть достаточно xmllint --encode koi8-r ... ?

> Там же пример длинной команды с параметрами лучше оформлять не
> command, а example.

Ok, учту

> Там же избыточные (IMHO) личные обращения. Вообще непонятно,
> зачем в тех. документации личные обращения.

Личные обращения? Где?

> Странно, что этот документ и стили, на которые он ссылается,
> лежат в разных местах, а не на docs.altlinux.ru

А доступ к сундуку с кащеевой смертью у кого? :-)

> Странно, что
> http://lrn.ru/~avp/wiki/pt03.html
> отчасти дублирует
> http://docs.altlinux.ru/alt/devel/ar01s08.html

да

> 
> Вообще весь этот документ неплохо бы интегрировать в cvs docs,
> общую структуру документов (alt/devel), и как-то совместить в
> docs-howto. Сейчас наличие двух разных документов лично мне
> напоминает ведение параллельной ветки.

давайте займёмся этим после сдачи документации в печать

> Также не уверен в том, что такие описания нужно делать в виде
> FAQ - некоторые вопросы должны содержать не просто набор шагов, а
> полное объяснение, почему так делается и зачем.

Так оно и предполагается.

-- 
Alexandre Prokoudine
ALT Linux Documentation Team