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

[Andriy Dobrovol's'kii]

Anton V. Boyarshinov пишет:
> On Fri, 17 Jan 2003 13:04:35 +0300 Anatoly A. Yakushin
>  wrote:
> 
> 
>>>>А то, как показал опыт, правка уже размеченного документа -
>>>>дело очень непростое.
>>>
>>>
>>>Не вижу ни малейших сложностей. А в чём проблема с
>>>вычитыванием размечнного документа? Если очень мешают тэги --
>>>никто не мешает их скрыть (в emacs C-c Tab).
> 
> 
>>Проблема собственно с организацией этого процесса.
>>Как получилось в этот раз - те кто реально мог вычитывать, не
>>могли править, бо не было доступа в cvs.
> 
> 
> Так это безотносительно к наличию/отсутствию разметки.
> 
> 
>>У тех, кто мог править, не было времени эти ошибки исправлять.
>>Поэтому, IMHO, в этом процессе надо что-то менять.
> 
> 
> Да, надо, несомненно. В его организационной части. Но это не
> значит, что надо отбрасывать все преимущеста использования
> разметки.
> 
> Антон
> 
> PS позволю себе высказаться несколько грубо, но прямо: решение о
> работе с текстами в plain text и разметке их после литвычитки
> может быть принято только через мой труп, как участника проекта.
> Я не склонен преувеличивать свою значимость, но я не уверен, что
> найдётся достаточно квалифицированый человек, который сочтёт
> такую схему (plain text) разумной.
Проблема не в наличии разметки.
_Проблема_в_наличии_права_что-то_править._
И именно эту проблему нужно решать. А разметку, при вычитке вообще 
трогать незачем, ИМХО. Это удел тех. редакторов. :) Нужна 
возможность именно литературной корректуры. В тот момент времени 
когда у желающего внести вклад есть время.
_И нужен механизм согласования действий не зависящий от конкретного 
человека._ Александр просто не успеет за всем следить. Изначально 
CVS и была выбрана за возможность коллективной работы с файлами. Но 
возможности эти сейчас совершенно не используются. Прикасаться к 
файлам в CVS могут только авторы. Хотя мы с Олегом спокойно 
поработали через CVS и ничего страшного не случилось. :))

-- 
Rgrds,
Andriy
*********************************************************************
email: dobr at iop dot kiev dot ua            Kyiv, Ukraine
Phone: (380-44)   265-7824            Department of Gas Electronics
Fax:   (380-44)   265-2329             Institute of Physics of NASU
*********************************************************************