[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