Tim Daly <d...@axiom-developer.org> writes: > On 1/6/2011 12:03 AM, Eric Schulte wrote: >>> Can you post examples of these? I'd love to see some other examples. >> Sure thing, check out this old version of a file which tangles out into >> the directory layout expected by lein. >> http://gitweb.adaptive.cs.unm.edu/?p=asm.git;a=blob;f=asm.org;h=f043a8c8b0a917f58b62bdeac4c0dca441b8e2cb;hb=HEAD > I see that this file is using chunk markup but I don't see > the "ideas-to-implementation" (I2I) explanation. That is, I > don't see text that is written so someone like me can read the > text, understand the ideas and how they translate to code. >
True, unfortunately I don't have any good examples where I write in an I2I style. I think the discipline needed to sit down and document ones initial ideas may be one of the largest hurdles to a wider adoption of LP practices. However there are more examples of org-mode usage available online at http://orgmode.org/worg/org-contrib/babel/uses.html > >> Also, this project has an org-mode front page with code examples, the >> html woven from this front page is shown at >> http://repo.or.cz/w/neural-net.git >> and the raw org file is available here >> http://repo.or.cz/w/neural-net.git/blob/HEAD:/neural-net.org > I love the graphics in this example! But, alas, this also seems > to be disconnected from the I2I property. But this is VERY > encouraging since it shows that you can get beautifully formatted > documents from the source. Thanks, you may also notice that the graphics are actually produced from inline LaTeX (using tikz) avoiding the need for external binary files and allowing everything to be handled nicely by git. > >> I'll have to check out clojure.pamphlet, it sounds like an elegant >> alternative. It's always interesting to see other solutions in this >> space. For example I think scribble is a nice tool from the scheme >> world. http://lambda-the-ultimate.org/node/4017 > Take a look at http://daly.axiom-developer.org/clojure.pdf > Very nice, I think this has become my new reference for code in the Clojure core. Is the .clj or .tex file available as well? > > The key difference, at least from my perspective, is that the CISP > is (well, is slowly being) organized around ideas. The goal is to > introduce the ideas and explain them in enough detail to *motivate* > the code that follows the explanation. > > If you handed your printed document (or pdf) to someone will they > come away with enough understanding of neural networks to be able > to explain your code? Can they read the pdf and know what to change > and where to change it? Do they have literature references to follow > for deeper information? Is there a usable index with proper cross > references so they can hyperlink to the explanation and its associated > code block? These things seem, in my opinion, necessary (but not > sufficient) for the I2I property to hold. > > I think that the tool you have is very, very nice. It shows me that > it would make a proper substitute for my beloved Latex as a viable > alternative for literate programming. > Thanks, and I agree the tool should support LP/I2I style composition, the main hurdle is getting users (including myself) to write code in that style (regardless of the tool used). Best Regards -- Eric > > Tim Daly -- 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
