Re: [Axiom-developer] literate programming in html

[Martin Baker]

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