[docs] Re: документация по docbook
Alexandre Prokoudine
avp на lrn.ru
Пт Фев 25 15:59:53 MSK 2005
Kirill Maslinsky пишет:
>>Упрощу вопрос: при помощи каких технических средств при сборке
>>документации для ДИСТРИБУТИВА будет автоматически проставляться его
>>[дистрибутива] название ?
>
>
> Упрощу ответ: не нужно в документации к дистрибутиву на каждой странице
> писать "в данном ДИСТРИБУТИВЕ", если речь _не_ идёт о специфике
> именно данного дистрибутива. А если идёт о специфике, _не надо_
> его название подставлять АВТОМАТИЧЕСКИ.
ОК, двигаемся дальше. Принимая во внимание аксиому
Сизиф != решение
получаем, что
компонент решения из текущего среза Сизифа != тот же компонент в составе
решения, извлечённый из дерева любой воображаемый промежуток времени назад
Таким образом при подготовке документации к первому же решению на основе
Сизифа получаем необходимость РУЧКАМИ править часть текста для уточнения
специфики.
Не будет ли в таком случае логичнее ввести в боевой режим механизм
профилирования документации, при котором специфическую часть текста
можно пометить как таковую при помощи механизма id, либо расширением
имеющегося DTD (скажем, добавлением атрибута solution к используемым
тэгам), что позволило бы в любой отдельно взятый момент времени получить
документацию к нужному релизу из документации к Сизифу простой
настройкой мэйкфайла?
Или ты предпочитаешь решать эту проблему иными техническими или
административными средствами? :)
А.П.
Подробная информация о списке рассылки docs