[docs] docs feedback loop (was Re: Source XML vs source LaTeX - LAST round)

Mikhail Zabaluev mhz на altlinux.org
Ср Июн 18 14:13:49 MSD 2003


Hello Michael,

On Wed, Jun 18, 2003 at 12:35:33PM +0300, Michael Shigorin wrote:
>
> On Wed, Jun 18, 2003 at 01:00:00PM +0400, Anton V. Boyarshinov wrote:
> > > На сейчас она безнадежно плоха, т.е. J1.1 обладал лучшим
> > > соотношением цена/содержимое.
> > Имеется в виду содержимое как текст или как качество его
> > оформления?
> 
> В первую очередь текст.
> 
> Пользователь сталкивается с серьезными ошибками, о которых в
> книжке ни слова.

Ну, это уже к DocBook vs. LaTeX никакого отношения не имеет.

Нужно обеспечить feedback на стадии разработки документации.
Выставить текущую документацию из CVS для всеобщего обозрения.
Собирать из неё нормальный вебсайт docs каждую ночь
после commit'ов. Залинковать этот сайт с главной страницы.
Сделать на заглавной странице или даже в обрамлении каждой страницы
ссылку на страницу, где рассказывается, как сообщать об ошибках
в BTS docs.

-- 
Stay tuned,
  MhZ                                     JID: mhz на altlinux.org
___________
If the future isn't what it used to be, does that mean that the past
is subject to change in times to come?
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: отсутствует
Url     : /pipermail/docs/attachments/20030618/e8b4ab22/attachment.bin


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