On Tuesday, May 6, 2014 2:22:13 PM UTC-5, da...@axiom-developer.org wrote:
>
> Gregg, 
>
> > My original comment on litprog ("bad bad bad") was admittedly a little 
> > strong.  I think its bad for some things, fine for others.  And it's 
> > possible litprog conventions will evolve to address the problems some of 
> us 
> > see with using it for programming in the large etc. 
>
> Could you explain what "some of the problems some of us see with using 
> it for programming in the large" might be? It is hard to refute 
> "bad bad bad" and other assertions without specific examples. 
>
> Axiom (1.2 million lines of lisp) is being rewritten into a literate 
> program. So far I can't think of a problem. Clojure is being reworked 
> into literate form already and I can't see a problem other than trying 
> to understand and explain code I didn't write (reading code is hard). 
>
> The Clojure community isn't ready to make the leap into a literate 
> world. I understand that. But Clojure is still at the stage of writing 
> new code for new uses. There are few people who need to modify code 
> written by programmers who left the community. That's when the need 
> will arise for clearly communicating ideas to other humans. 
>
> The technical debt has not come due ... but it will. 
>
> Tim 
>

Previous posts in this and related threads make it clear that some people 
dislike literate programming as a general requirement.  I am one of them.  
At the same time, I think that literate programming is probably a Good 
Thing in certain contexts.  Some kinds of coding probably benefit from 
L.P.  At the very least L.P. a good thing in some contexts simply in that 
some people like it.  So I support it use in appropriate contexts--e.g. for 
projects carried out by people who like it, or for projects that would seem 
to derive special benefits from it.  I don't believe that L.P. is either 
necessary or sufficient for good documentation, and I would be dismayed if 
it were adopted as a general norm for Clojure.

-- 
You received this message because you are subscribed to the Google
Groups "Clojure" group.
To post to this group, send email to clojure@googlegroups.com
Note that posts from new members are moderated - please be patient with your 
first post.
To unsubscribe from this group, send email to
clojure+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/clojure?hl=en
--- 
You received this message because you are subscribed to the Google Groups 
"Clojure" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to clojure+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to