Re: [Axiom-developer] Re: A modest proposal

[Stephen Wilson]

Ralf Hemmecke <address@hidden> writes:

> > I dont do that myself.  I write my code as most other programmers do.
> 
> Because you are trained in programming. But what you do is writing the
> program for yourself. Not for other people.

Sorry, I dont understand why you would jump to that conclusion.
Although I have not released a literate document for inclusion in the
project,  I certainly have stuff pending.  Im taking my time.

I will be writing for others, including myself.  In ten years time the
code I write today may as well have been written by another.

[...]
> Anyway, write your code as you like, nobody is forcing. The only thing
> is that one should not forget that LP is not about documenting a
> program. It is about documenting an idea where the documentation is
> equipped with real code. Human understandable, of course.

Im pretty sure we are on the same page.  Im not at all certain what it
was about my post that implied otherwise.

> If that is the final product that you give to the public nobody
> cares how it was produced. I have not yet heard of someone who has
> good guidelines of how to produce a nice literate document.

Sure.  Guidelines are probably a waste of time.  As I said, the
challenge is for the individual to figure out what works for them.

> Additionally, one should also distinguish at least 3 cases.
[...]

Yes, absolutely.  There are at _least_ 3 cases.  Probably half a dozen
more which any one of us will encounter during or work.  One thing is
clear, at least to me:  Literate programming does not get in the way
given a little bit of imagination.

Take care,
Steve