[docs] Re: devel book

[Alexandre Prokoudine]

On Mon, 17 Feb 2003 12:53:09 +0300
Vitaly Ostanin <vyt на vzljot.ru> wrote:

> 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.

То есть при сборке книги будет использовать некий общий тег, скажем,
<distribution/>, который по факту каждой отдельной сборки будет
обрабатываться и преобразоваться, например, в ALT Linux Master 3.0 и
т.п.? Я изначально за гибкость и против "прибивания гвоздями".

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