[docs] Re: Chapters and articles

[cornet]

Vitaly Ostanin wrote:
> 
> On Tue, 5 Nov 2002 13:18:54 +0300
> Alexandre <avp на altlinux.ru> wrote:
> 
> > 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
> > > идут уровнем выше.
> >
> > На задачи. Я не вижу смысла в сосредоточениина приложениях. Мы
> > же не журнал делаем :-)
> 
> Давайте ориентироваться на документы. Если какие-то из документов
> нужно включить лишь частично, и под другим корневым тегом, то
> это легко делается с помощью XInclude.
> 
> По поводу jabber-common и psi:
> в текущем состоянии (и по смыслу) они оба - статьи (article),
> которые должны быть переделаны в главы (chapter). Если для
> Мастера будут ограничения по объёму, то нужно об этом
> предупредить.
> 
> Не вижу смысла вводить дополнительный промежуточный уровень
> (Web, Mail, Instant Messaging) всего для двух документов в
> каждом, при этом кастрировать их из article в section.

Почему для двух документов?? А описание толпы клиентов ICQ разве
не сюда надо будет складывать когда они появятся современем? Да
мало ли какие ещё будут средства общения... как раз раздел
Instant Messaging имено для таких документов. ИМХО.

skip.

-- 
Власенко Олег.
Отдел технической поддержки ALT Linux Team.
mailto:cornet на altlinux.ru