[docs] Re: collaborative v2-alpha

[Alexandre Prokoudine]

On Thu, 13 Mar 2003 12:03:28 +0300
"Anton V. Boyarshinov" <boyarsh на ru.echo.fr> wrote:

> On Thu, 13 Mar 2003 11:59:13 +0300 Alexandre Prokoudine
>  wrote:
> 
> > > Что же касается приведённой схемы, то я не вижу причин, по
> > > которым первичная разметка должна обязательно быть простой и
> > > отличаться от окончательной. 
> > 
> > Это даёт возможность людям, не знакомым с разметкой DB/XML,
> > вносить правку прямо в текст. Это нормальная практика для любых
> > публикаций -- как онлайновых, так и оффлайновых.
> > 
> > > Кроме того, следует учесть, что
> > > процесс подкотовки документации у нас цикличен.
> > 
> > само собой
> 
> А вот тут возникает некоторое противоречие. Дело в том, что
> документы, которые входили в предидущий релиз уже размечены (в
> идеале) весьма подробно, а вот правку в них вносить часто ой как
> надо... Это с одной стороны. А с другой -- чем меньше мы
> оставляем на предрелизное время -- тем больше вероятность что нам
> понравится результат.

1. Без довёрстывания всё равно не обойтись.
2. Довёрстывание должно идти после литправки.
3. Если документация по фактическим моментам не соответствует
программной части, на программу и документ вешается block в BTS. Это
жестоко, зато позволяет избежать серьёзных проколов. Вешается,
разумеется, не в последний момент, а, скажем, за месяц до релиза.

Я что-то пропустил? ;)

-- 
Alexandre Prokoudine
ALT Linux Documentation Team
JID: avp на altlinux.org