OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [docbook-apps] Help for book organization choices


I wonder if this is actually a set of books.  DocBook has a set element
that is the parent of book.  Then the company manual would be a set and
each individual department would be a book.

Larry Rowland

On Mon, 2006-05-08 at 09:42 +0200, Luciano Scavizzi wrote:
> Maybe I am a bit off-thread, but this is the only docbook community I
> am attending up to now, so I wouldn't know who to ask to.
> 
> I am planning to develop our company "Policies and Procedure Manual"
> (which is the only company document depending entirely on me) using
> docbook.
> 
> Logically, the hyerarchy would be:
> 
> Company Manual
> |--- Department Manual
> |    |--- Category
> |    |    |--- Policy / Procedure
> |    |    |--- Policy Procedure
> |    |--- Category
> |         |--- ...
> |---- Department Manual
>       |---...
> 
> Taken by itself, each Policy / Procedure is a stand-alone document,
> with its own author and revhistory and sometimes appendixes and so on,
> so it could be written as an article.
> 
> On the other hand, I would like to preserve the concept of the Manual
> integrity, so, maybe, it could be written as a book, but I am afraid,
> this way, to loose the single policy/procedure atomicity.
> 
> As I am still very uncertain among the pros and cons of each of the
> two options, I would like to have some opinion from people who are
> more experienced than me with Docbook about the way to obtain a good
> compromise between the various needs.
> 
> Thanks
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
> 


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]