[docs] Re: документация по docbook
Kirill Maslinsky
kirill на altlinux.ru
Пт Фев 25 15:43:38 MSK 2005
> >>Упрощу вопрос: при помощи каких технических средств при сборке
> >>документации для ДИСТРИБУТИВА будет автоматически проставляться его
> >>[дистрибутива] название ?
> >
> >Упрощу ответ: не нужно в документации к дистрибутиву на каждой странице
> >писать "в данном ДИСТРИБУТИВЕ", если речь _не_ идёт о специфике
> >именно данного дистрибутива. А если идёт о специфике, _не надо_
> >его название подставлять АВТОМАТИЧЕСКИ.
>
> Когда придётся вставлять вручную - мнение может и поменяться.
>
> Лишняя разметка не бывает лишней - её можно убрать стилями, или
> найти стилями документы, где она находится, и исправить фрагмент
> о специфике.
Дело здесь не в разметке, упоминать название дистрибутива там, где это
не оправдано, я считаю ошибкой в содержании текста, а вовсе не в его
разметке. Кроме того, лишняя разметка может очень ддаже оказаться
лишней; хотя бы потому, что стили, которые будут её убирать, нужно
ещё написать. А кто это будет делать? Вот уж точно не я.
--
Kirill Maslinsky
ALT Linux Documentation Team
Подробная информация о списке рассылки docs