[docs] Re: Making docs status in cvs

[cornet]

Vitaly Ostanin wrote:
> 
> On Sun, 10 Nov 2002 22:31:19 +0300
> cornet <cornet на altlinux.ru> wrote:
> 
> <skipped/>
> 
> > > > Фактически это лицо ответственное за выпуск документа и
> > > > поддержание его в актуальном состоянии.
> > >
> > > Это, скорее, редактор.
> >
> > Не совсем. Детактор это скорее лит-вычитка. А я говорю про
> > выпускающего - такой человек и за содержание отвечает и за код
> > xml.
> >
> > Пример:
> > samba.xml
> > Имеется 3 автора - я, Игорь Вергейчик, Александр Боковой.
> > При этом майнтейнер документа именно я. Когда мне потребуется
> > доработать контент по samba3 - обращусь к Вергейчику или
> > Боковому, когда доработка по samba2 - сделаю сам, когда
> > потребуется лит-вычитка - обращусь к Александру Прокудину. Но
> > за коректность xml, за правильность оформления и за готовность
> > документа к нужному сроку в нужном виде отвечаю именно я.
> 
> Обязательно нужно быть одному?

Да. Это с организационной точки зрения. С одного человека всегда
легче спрашивать дело и сроки, чем с группы.
Если есть ответственность "за ...", то эта отвественность должна
лежать единовременно только на одном человеке.

> Поскольку это не принципиальный
> вопрос, а разрешение в DTD нескольких мантейнеров ничем не мешает
> (и может быть изменено в дальнейшем), пусть оно будет.

Ну технически - всегда пожалуйста :-) Я говорю именно об
организационной стороне дела.
 
> > > > Разумеется этот человек одновременно может быть (и как
> > > > правило будет) одним из авторов.
> > > > Всё общение с авторами документа возлагается на
> > > > майнтейнера.
> > >
> > > Это когда дойдём до policy с документами. Авторы здесь вообще
> > > ни при чём.
> >
> > А какие мысли есть на счет policy ??
> 
> Что неплохо бы его написать (вписать в docs-howto), но не сейчас.
> 
> <skipped/>
> 
> > > > Например, в ent/authors.ent записываем:
> > > > <!ENTITY cornet
> > > > "<firstname>Vlasenko</firstname><surname>Oleg</surname><af
> > > > fili
> > > > ation><address><email>cornet на altlinux.ru</email><otheraddr
> > > > ></o
> > > > theraddr></address></affiliation>">
> > > >
> > > > А в теле документа пишем:
> > > > <authorgroup>
> > > >   <author lang="en">
> > > >     &cornet;
> > > >   </author>
> > > > </authorgroup>
> > >
> > > Лучше взять уровнем выше - делать сущности с началом на
> > > <author>.
> >
> > Не уверен что это правильно - один и тот же человек в разных
> > документах может быть и author и othercredit и ещё как то.
> > Как раз суть моего предолжения - загонять в сущность свойства
> > самого человека. А вот его роль в создании документа должна
> > описываться в самом документе.
> 
> Ясно. В общем, мысль хорошая, но делать это надо не в ENTITIES
> (которые вообще-то не XML, а SGML-ориентированы), а в одном
> xml-файле со всеми авторами. В него можно записать имена авторов
> на (пока) обоих языках, адреса, и уникальный идентификатор
> автора (сочетание имени, отчества и фамилии), по которому автор
> будет включен в документ через XInclude(#xpointer).

Ну это уже Вам виднее как и чего сделать :-) Тут у меня
аргументированного мнения просто нету.
 
> > > Кстати, недавно пришли к тому, что имена должны быть на
> > > русском.
> >
> > А нельзя выбор написания имени как то завязать с lang="ru" и
> > lang="en"
> > ??
> 
> Можно, если включать имена авторов без явного указания
> языка, и запинав стили на использование общего авторского
> xml-файла. Это сложно делать, комфортно использовать, но времени
> сейчас нет.

Значит в TODO. Ok?

-- 
Власенко Олег.
Отдел технической поддержки ALT Linux Team.
mailto:cornet на altlinux.ru