[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Axiom-developer] literate programming in html

From: Martin Baker
Subject: Re: [Axiom-developer] literate programming in html
Date: Fri, 20 Jan 2012 15:43:26 +0000
User-agent: KMail/1.13.6 (Linux/; KDE/4.6.0; x86_64; ; )

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:
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.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]