[docs] Re: devel book

[Vitaly Ostanin]

On Mon, 17 Feb 2003 10:12:05 +0300
"Anton V. Boyarshinov" <boyarsh на ru.echo.fr> wrote:

> Добрый день
> 
> 
> On Fri, 14 Feb 2003 18:19:33 +0300 Vitaly Ostanin
>  wrote:
> 
> Можно мои 5 копеек?
> 
> > > > Итак, кто из них должен остаться?
> 
> Я думаю -- оба.
> 
> > > CVS/docs/devel
> > 
> > Книгу alt удалять? Куда будем класть документы с ALT policy,
> > с описанием sisyphus, которое постоянно повторяются и т.п.?
> > По смыслу это должно было лежать в alt/public.
> > 
> > Мне не нравится этот перенос документов.
> 
> Я считаю, что ничего никуда переносить не надо (по крайней мере
> перечисленное). Документы в cvs должны лежать ПО СМЫСЛУ.
> alt-packaging ИМХО место именно в alt, а cvs -- в devel. И я не
> вижу ничго страшного в том, что мы включаем часть одного в
> другое. Книги неизбежно будут пересекаться, как ОО входит в
> user, а junior по большей степени состоит из кусков других
> книг. Это нормально. И не надо ради конкретного издания/релиза
> таскать туда-сяда документы. 

Золотые слова. С помощью arrange.xsl это реализуемо уже сейчас.
Тогда переделаю alt-packaging.xsl в section.

Саш, скажи свои 10 копеек, please :)

> Появилась по этому поводу мысль -- отделить обьединяющие
> документы в отдельные деревья. Складывать в admin, user, devel,
> alt etc документы по смыслу, а объединение их в книги
> производить в admin-guide, user-guide и пр. Исходя из задач
> данной книги, а не из сложившейся структуры cvs.

Тоже хорошая мысль. Для книг нужно ещё версию дистрибутива
указывать - master-2.2-admin. Ещё можно складывать такие книги
в отдельный каталог, вроде published-books.

<skipped/>

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