[docs] Re: documentation.xml

Alexandre Prokoudine avp на altlinux.ru
Чт Июн 26 16:32:36 MSD 2003


On Thu, 26 Jun 2003 13:05:56 +0400
Vitaly Ostanin <vyt на vzljot.ru> wrote:

> Крайне мало ссылок. linux, altlinux, GNU, KDE/Gnome...

Ага, я  посмотрю...

> Слова "опции" решили избегать.

Хм, где-то на больную голову затесалось...
Проверю, спасибо!

> Последний абзац - шедевр длинной фразы в один абзац :) Вообще в
> документации для начинающих лучше делать небольшие абзацы - и так
> тяжело читать текст с кучей новой информации.

Проверю

> Каталог "/docs" и каталог "docs" на загрузочном диске - разные
> вещи.

Не совсем понял тебя...

> Ещё про последний абзац - в одной фразе дважды почти подряд
> идёт ссылка на bugs.altlinux.ru.
> 
> В 4-м с конца абзаце опечатка "мы можете".

ок

> 
> "CHANGELOG" обычно пишут как "ChangeLog", AFAIK.

Как только не пишут...

> Раздел "Литература" напоминает "Список литературы" ;) IMHO, лучше
> "Полезные книги" или "Рекомендуемая литература". А, понял,
> используется тег biblioentry. По-моему, он задуман как раз для
> списка использованной литературы.

Есть более "концептуальные" варианты, чем <orderedlist/> с
собственным <title>Рекомендуемая литература</title>? :)

> Слишком много личных обращений. Так и задумано?

Проверю

-- 
Alexandre Prokoudine
ALT Linux Documentation Team
JabberID: avp на altlinux.org
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 481 байтов
Описание: отсутствует
Url     : /pipermail/docs/attachments/20030626/15f58e92/attachment.bin


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