[docs] Re: документация по docbook

Alexandre Prokoudine avp на lrn.ru
Пт Фев 25 15:59:53 MSK 2005


Kirill Maslinsky пишет:
>>Упрощу вопрос: при помощи каких технических средств при сборке 
>>документации для ДИСТРИБУТИВА будет автоматически проставляться его 
>>[дистрибутива] название ?
> 
> 
> Упрощу ответ: не нужно в документации к дистрибутиву на каждой странице
> писать "в данном ДИСТРИБУТИВЕ", если речь _не_ идёт о специфике 
> именно данного дистрибутива. А если идёт о специфике, _не надо_ 
> его название подставлять АВТОМАТИЧЕСКИ.

ОК, двигаемся дальше. Принимая во внимание аксиому

Сизиф != решение

получаем, что

компонент решения из текущего среза Сизифа != тот же компонент в составе 
решения, извлечённый из дерева любой воображаемый промежуток времени назад

Таким образом при подготовке документации к первому же решению на основе 
Сизифа получаем необходимость РУЧКАМИ править часть текста для уточнения 
специфики.

Не будет ли в таком случае логичнее ввести в боевой режим механизм 
профилирования документации, при котором специфическую часть текста 
можно пометить как таковую при помощи механизма id, либо расширением 
имеющегося DTD (скажем, добавлением атрибута solution к используемым 
тэгам), что позволило бы в любой отдельно взятый момент времени получить 
документацию к нужному релизу из документации к Сизифу простой 
настройкой мэйкфайла?

Или ты предпочитаешь решать эту проблему иными техническими или 
административными средствами? :)

А.П.


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