[docs] persons.xml

Kirill Maslinsky kirill на altlinux.ru
Чт Окт 27 18:07:02 MSD 2005


Добрый вечер!

> В alt-entities находится persons.xml, содержащий список
> разработчиков, правильное написание их имён на русском и других
> языках, контактные адреса.
> 
> В своё время этот файл использовался при указании авторства
> документации и при подготовке списка разработчиков дистрибутивов.
> 
> Вопрос - в нынешней схемах подготовки документации этот файл
> нужен, нужно ли его обновить к Compact 3.0 ?

Ситуация такая: вся старая инфраструктура сборки (alt-docs-xsl, alt-entities)
по-прежнему используется для сборки документов из формата DocBook/XML.
Отказываться от неё мы не собираемся, потому чо в ней очень много сделано
хорошего, это просто теперь не единственный вариант, а один из.

В документации Compact3.0 порядочное количество документов, спортированных
из cvs/docs, соответственно, в них авторы указаны с опорой на persons.xml.
Так что ответ на первый вопрос -- да, файл безусловно нужен.

Что касается обновления: если появятся новые авторы, которые будут пользоваться
не стандартным DocBook, а docs.dtd -- тогда и нужен будет этот список.
Пока таких нет, можно и не беспокоиться (но и не забывать навсегда) об 
обновлении. Определённо одно -- в persons.xml не нужно вносить авторов, 
которые на DocBook не пишут, это будет просто лишняя работа.

-- 
Kirill Maslinsky
ALT Linux Documentation Team
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://lists.altlinux.org/pipermail/docs/attachments/20051027/036625e9/attachment.bin


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