[docs] Re: Making docs status in cvs

[Vitaly Ostanin]

On Sun, 10 Nov 2002 01:42:45 +0300
cornet <cornet на altlinux.ru> wrote:

<skipped/>

> 2. У каждого документа единовременно может быть только один
> майнтейнер - как у rpm-пакета.

Не уверен, но это и не важно. Пусть будет только один. (Горец :))

> Фактически это лицо ответственное за выпуск документа и
> поддержание его в актуальном состоянии.

Это, скорее, редактор.

> Разумеется этот человек одновременно может быть (и как правило
> будет) одним из авторов.
> Всё общение с авторами документа возлагается на майнтейнера.

Это когда дойдём до policy с документами. Авторы здесь вообще ни
при чём.

> Вот, отсюда следствия - необходимо оставить в данном документе
> только одну запись:
>    <mantainer>
>      <name>Foo</name>
>      <email>Bar</email>
>    </mantainer>
> а список авторов всегда можно взять из основного документа,
> статус которого мы описываем.

Да. Оттуда же будем брать и полное название документа.

> Ну и в качестве общего предложения:
> Вытеснить ВСЕХ авторов в общий ent/authors.ent а в документах
> соответственно использовать только сущности. В этом случае мы
> отстреливаем сразу двух ушастых - имеем общий список авторов в
> одном общем файле, причем со всеми их атрибутами, и можем с
> минимальными изменениями вносить правки - если например у кого
> то из плодовитых авторов изменился почтовый адрес то менять
> прибется только в одном файле ent/authors.ent а не во всех,
> автором которых он является. Так же существенно упрощается
> изменение списка атрибутов авторов если мы захотим что либо
> менять в будущем.

> Например, в ent/authors.ent записываем:
> <!ENTITY cornet
> "<firstname>Vlasenko</firstname><surname>Oleg</surname><affili
> ation><address><email>cornet на altlinux.ru</email><otheraddr></o
> theraddr></address></affiliation>">
> 
> А в теле документа пишем:
> <authorgroup>
>   <author lang="en">
>     &cornet;
>   </author>
> </authorgroup>

Лучше взять уровнем выше - делать сущности с началом на <author>.
Кстати, недавно пришли к тому, что имена должны быть на русском.

> Мнения?

Я за. Ещё мнения?

<skipped/>

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