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.
Its just that the method Tim describes for embedding code into html here: http://axiom-developer.org/axiom-website/litprog.html has some complications and requires specialised tools. 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 debugging tools? * 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. Martin _______________________________________________ Axiom-developer mailing list Axiom-developer@nongnu.org https://lists.nongnu.org/mailman/listinfo/axiom-developer