[docs] Re: patches

Vitaly Ostanin vyt на vzljot.ru
Пн Мар 17 14:27:07 MSK 2003


On Mon, 17 Mar 2003 14:13:30 +0300
Alexandre Prokoudine <avp на altlinux.ru> wrote:

> On Mon, 17 Mar 2003 13:54:13 +0300
> Vitaly Ostanin <vyt на vzljot.ru> wrote:
> 
> > $ make check
> > 
> > То, что оно собирается, понятно. В общем, если книги не будут
> > валидны, я не берусь их перемещать в books/master-2.2.
> > Писать и проверять стили на невалидных документах тоже
> > неудобно.
> 
> Ещё раз объясняю русским по белому :-)
> Показываемые ошибки имеются только из-за наличия <para/> перед
> следующим далее <section/>

Тогда я тоже повторюсь :) При переносе, сборе, обрабоке
документов стилями могут возникуть ошибки. Гораздо удобнее, когда
ошибки либо есть, либо нет, чем когда часть из них "нормальные",
а часть надо править.

> Мне интересно, является ли это critical bug из-за которого
> ничего не будет работать?

Нет. Если интересно, почему я так ратую за валидность, перенеси
объединения документов из user в books/master-2.2/user, и убедись
что make html-dir делает всё правильно.

> > Кстати, books/master-2.2 сейчас уже не имеет смысла, IMHO,
> > если нельзя проставить теги на тот момент, в который
> > собирались релизные доки.
> 
> твои предложения?

Выложить на docs.altlinux.ru ту html-сборку, которая попала на
диски Master-2.2 и считать доки master-2.2 неподдерживаемыми для
сборки из cvs.

Сделать "books/next-release", где экспериментировать с
автоматической заменой entities для названия дистрибутива.

Ответить мне всё-таки на вопрос, кто будет заниматься docs-howto
или его заменой.

Написать policy для публикации релизов.

<skipped/>

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


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