[docs] зачём авторы?

[Kirill Maslinsky]

Добрый день!

>   Во-первых, напомните ответ на такой вопрос: а зачем вообще кому-то надо
> что-то писать? Это вроде бы обсуждалось, но я не могу найти в архивах.

Вообще говоря, в этом задача проекта документации. Посмотрите первый 
раздел ftp://ftp.altlinux.org/pub/docs/adt_policy.tar.gz, там 
написаны задачи проекта, которые нам таки удалось сформулировать 
общими усилиями после долгих обсуждений в рассылке. Как будто бы 
с ними все более/менее согласились. Так вот задача проекта не 
сводится к выпуску документации к дистрибутивам ALT, а к созданию 
репозитория документации, на основании которго можно будет делать 
такие выпуски.

>   К чему я: в adt_policy есть раздел "задачи проекта", но мне кажется,
> что успешность проекта будет оцениваться исключительно по одному критерию:
> есть или нет печатная документация к очередному дистрибутиву. Поэтому,
> с высокой долей вероятности, именно печатной документацией проект и будет
> заниматься. Документация уже написана и остаётся почти неизменной между
> релизами. Для поддержания актуальности достаточно одного человека (что,
> похоже, и происходит).

Реакция на последний выпуск документации (ALM 2.4) показывает, что это 
не так. 
Я сам вижу, что документация неполна, не покрывает многих тем и т. п.
Неизменной она остаётся именно потому, что не пишут новую документацию
(хотя и это неправда, если Вы посмотрите внимательно, увидите -- 
что многое было написано заново).

-- 
Kirill Maslinsky
ALT Linux Documentation Team