[docs] Re: Branches and release of docs

Vitaly Ostanin vyt на vzljot.ru
Ср Ноя 6 16:09:57 MSK 2002


On Wed, 6 Nov 2002 16:04:21 +0300
"Anton V. Boyarshinov" <boyarsh на ru.echo.fr> wrote:

> Добрый день
> 
> On Wed, 6 Nov 2002 15:54:10 +0300
> Vitaly Ostanin <vyt на vzljot.ru> wrote:
> 
> > Есть предложение завести отдельную ветку для документации,
> > собранной для Мастер 2.2.
> 
> Я с одной стороны за, а с другой -- нет ;)
> 
> + можно будет спокойно работать над документами Мастера, не
>   отвлекаясь на концептуальные споры ;)
> 
> - но ведь потом всё это надо будет объединять 8-| Слияние
>   изменений в данном случае может оказаться не простым делом

В релизных ветках не должно быть кардинальных изменений
документов - только их объединение, сортировка документов в нём,
опции сборки.

> > Это позволит объединять доки для конкретного релиза, не
> > задумываясь о том, как подходить к документам - как к
> > документам, или как к задачам :)
> 
> skip
> 
> > Я по прежнему считаю, что документ нужно воспринимать как
> > нечто цельное по смыслу (глава, статья), а как нарезку частей
> > для печати или online.
> 
> Не совсем понял эту мысль.

IMHO, не нужно подгонять документы под конкретный релиз, книгу и
т.д. Возможностей profiling и XInclude вполне хватает для
объёдинения документов или их частей.

> > Лучше, если ветку заведут люди, хорошо знающие cvs, а
> > остальные прочитают доки по cvs, чтобы ничего не поломать.
> 
> Я могу завести, если никто не против.

Я за :)

<skipped/>

-- 
Regards, Vyt
mailto:  vyt на vzljot.ru
JID:     vyt на vzljot.ru
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: отсутствует
Url     : /pipermail/docs/attachments/20021106/2706848b/attachment.bin


Подробная информация о списке рассылки docs