Documentation Template System is now more complex than brain surgery

[Tad Anderson]

You need to build a way to see all the links between all the templates and there fragments visually.

Just a simple class diagram that shows the relationships.

A large bonus would being able to also see the attributes on the fragments and what they have enabled.

I had a very hard time getting people to work with the old system.  I am not even going to try with this system until it is more transparent and user friendly.

It has been made way too complex, but some reporting capability and visual representation could fix that, and actually make it powerful.  That is what I think you were trying to do.

[Tad Anderson]

No one else having this issue???

[Geert Bellekens]

No one else having this issue???

To be honest, no

Yes sure the template system is complex, but so is the problem domain.
It's only since the last few version that it is complex enough to suit my documentation needs.

I'm not saying that it can't be improved, but I'm currently pretty happy with the current state and flexibility of the document generator system.

Geert

[Uffe]

It's only since the last few version that it is complex enough to suit my documentation needs.

Well, it's getting there. Still not enough flow control, but it's getting there.

But I agree that a way to visualize the design would be useful. I currently do this maunally, which is time consuming.


/Uffe