[docs] Re: documentation.xml

[Vitaly Ostanin]

On Tue, 24 Jun 2003 21:13:21 +0400
Alexandre Prokoudine <avp на altlinux.ru> wrote:

<skipped/>

> > Пока не сформировалась окончательная структура сайта, лучше
> > давать ссылки на его корень.
> 
> Ты сначала _текст документации_ прочитай, ладно? :-)))

Ок :) Я вообще ступил - решил, что речь о docs.altlinux.ru

Кстати, по documentation.xml:

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

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

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

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

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

В 4-м с конца абзаце опечатка "мы можете".

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

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

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

-- 
Regards, Vyt
mailto:  vyt на vzljot.ru
JID:     vyt на vzljot.ru
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: отсутствует
Url     : /pipermail/docs/attachments/20030626/2c5af420/attachment.bin