[docs] Chapters and articles

Alexandre avp на altlinux.ru
Вт Ноя 5 13:18:54 MSK 2002


On Tue, 5 Nov 2002 13:14:14 +0300
"Anton V. Boyarshinov" <boyarsh на ru.echo.fr> wrote:

> On Tue, 5 Nov 2002 12:26:02 +0300
> Alexandre <avp на altlinux.ru> wrote:
> 
> > Кроме того, вчера мы с Виталием Останиным обсуждали вопрос
> > включения jabber-common и Psi в документацию. Как вы видите,
> > оба документа включены в User guide. Однако, я настаиваю, чтобы
> > структура выглядела так:
> > 
> > book - Руководство пользователя
> > ...
> > part - Сетевая коммуникация
> > chapter - Web
> > section - Введение
> > section - Mozilla Navigator
> > chapter - Mail
> > section - Введение
> > section - Mozilla Mail & News
> > chapter - Instant Messaging
> > section - jabber-common
> > section - Psi
> 
> При наличии всех перечисленных документов -- логично. Впрочем,
> это вопрос "оси" документации. Если мы делаем документацию
> ориентированную на задачи -- тогда так. Если на программы --
> тогда вся мозилла должна быть в одном месте,
> задаче-ориентированные chapter исчезают и jabber-common & psi
> идут уровнем выше.

На задачи. Я не вижу смысла в сосредоточениина приложениях. Мы же не
журнал делаем :-)

Александр



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