[ILUG] question : docbook/cvs users

[dara]

Many thanks for the feedback Ann,

>> -  having an index/toc, perhaps with 'links' to the sections 
>> described in docbook and where appropriate in the output format.
>
> Docbook can do this automatically. Read up on the stylesheets to 
> determine how you'd like this handled. It will also do all your intra 
> and inter document linking.

Cheers, I will look into this

> Other issues I have encountered which include:
>
> - There is a learning curve to write proper docbook xml.
> - People *still* focus too much on what they want things to look like 
> and don't pay attention to appropriate markup options.
> - People confuse the version control systems for the xml files with 
> the document publishing systems.
> - It becomes increasingly slow to render the docs tree, the more 
> documentation gets added. On the original machine we installed it, 
> documentation docs suggested you go get a cup of coffee while it parsed.

Thanks again,  you're feedback was very useful to me in raising some 
points I had not thought of and demonstrating that it is do-able.

> I suppose if you had the time to put into it you could restrict tags 
> accepted by your parser, basically customising your own simplified 
> docbook to reduce some of these risks.

Ah, time, the biggest issue I have at the minute.

If I every get around to having something working I'll be glad to 
feedback on the experience is anyone else is interested.

Regards

Dara