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