[docs] Возможная организация документации

Anton V. Boyarshinov boyarsh на ru.echo.fr
Пт Янв 17 10:44:39 MSK 2003


On Fri, 17 Jan 2003 00:51:20 +0300 Anatoly Yakushin
 wrote:

> Антон, а можно еще одно предложение. :)
> Может быть стоит размечать документы в docbook после
> литературной правки, но никак не раньше.

Нет, не стоит. Иначе эту работу придётся делать многократно. И
кто этим будет заниматься? Сейчас этим по крайней мере частично,
занимаются авторы. И мы будем использовать разметку, сделанную к
этому релизу для следующего.

> А вычитывать plain text.
> В принципе, насколько я помню издательское дело, там так и
> происходит. Набор - корректура - верстка.

Не всегда. При применениии языков разметки как правило именно так
как у нас.

> А то, как показал опыт, правка уже размеченного документа -
> дело очень непростое.

Не вижу ни малейших сложностей. А в чём проблема с вычитыванием
размечнного документа? Если очень мешают тэги -- никто не мешает
их скрыть (в emacs C-c Tab).

Антон
-- 
mailto:boyarsh на mail.ru
mailto:boyarsh на ru.echo.fr
 10:40am  up 52 days, 16:47,  9 users,  load average: 1.77, 0.52,
0.18



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