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

[Oleg A. Paraschenko]

  Добрый вечер,

On Mon, 28 Feb 2005 10:31:37 +0300
Kirill Maslinsky <kirill at altlinux.ru> wrote:

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

  Спасибо за эту фразу! Я понял, что не так. Я действительно
_не_ согласен. То есть, цели благие, но вероятность их осуществления
очень мала, ...

> Так вот задача проекта не 
> сводится к выпуску документации к дистрибутивам ALT,

  ... а вот это жизненно необходимо, от этого никуда не деться, поэтому
имеет смысл больше усилий вкладывать сюда.

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

  Надеюсь, после вынесения сборочной среды из CVS положение улучшится.

> (хотя и это неправда, если Вы посмотрите внимательно, увидите -- 
> что многое было написано заново).
> 
> -- 
> Kirill Maslinsky
> ALT Linux Documentation Team
> 



-- 
Oleg Paraschenko  olpa@ http://xmlhack.ru/  XML news in Russian