On Friday 20 Jan 2012 11:59:52 Ralf Hemmecke wrote:
> It all depends on your tools. If there were a tool that puts every code
> chunk into a separate file but while editing shows you the chunks in the
> order you want, you wouldn't care how your content is physically stored.
In some ways I find the current LP and hyperdoc stuff in Axiom flavors
actually makes it harder for me to produce the quality of documentation that I
would like, although moving to an html version like this would help, I still
think custom tools like this are a major problem.
I think it would be much better to use standard tools. I'm not sure that file
structure is the most important issue? This seems like a technical issue to
me. In the end the important issues to me are:
* Can I use standard tools that I already know to edit code, html and diagrams
in WYSIWYG mode.
* Does it require maintainence of specialised tools?
* Does it inhibit development of IDE capablitied like code completion and
* Does it make documentation harder to produce rather than easier?
* Is there duplication between LP, Hyperdoc, )show, etc.
I think there is a lot to be said for keeping the documentation (LP and
hyperdoc) on a server somwhere and only downloading code to users client.