diff --git a/changelog b/changelog index 38a9914..96bd57c 100644 --- a/changelog +++ b/changelog @@ -1,3 +1,6 @@ +20111129 tpd src/axiom-website/patches.html 20111129.01.tpd.patch +20111129 tpd src/axiom-website/litprog.html literate program example update +20111129 tpd src/axiom-website/documentation.html add Alexander quote 20111124 tpd src/axiom-website/patches.html 20111124.04.tpd.patch 20111124 tpd src/interp/c-doc.lisp treeshake compiler 20111124 tpd books/bookvol9 treeshake compiler diff --git a/src/axiom-website/documentation.html b/src/axiom-website/documentation.html index 88fceec..d9d00c4 100644 --- a/src/axiom-website/documentation.html +++ b/src/axiom-website/documentation.html @@ -123,6 +123,20 @@

Why Literate Programming?



+
+In my life as an artchitect, I find that the single thing which inhibits +young professionals, new students most severely, is their acceptance of +standards that are too low. If I ask a student whether her design is as +good as Chartres, she often smiles tolerantly at me as if to say, "Of +course not, that isn't what I am trying to do...I could never do that." +

+Then, I express my disagreement, and tell her: "That standard must be +our standard. If you are going to be a builder, no other standard is +worthwhile." +

+--Christopher Alexander, May 1996 in (Patterns of Software, Gabriel) +
+


The best programming language is English. Everything else is notation. diff --git a/src/axiom-website/litprog.html b/src/axiom-website/litprog.html index ad5a706..76620b2 100644 --- a/src/axiom-website/litprog.html +++ b/src/axiom-website/litprog.html @@ -72,6 +72,20 @@ We program to communicate to the machine, not to communicate to people.

1.2 Is there a better way?

+
+In my life as an artchitect, I find that the single thing which inhibits +young professionals, new students most severely, is their acceptance of +standards that are too low. If I ask a student whether her design is as +good as Chartres, she often smiles tolerantly at me as if to say, "Of +course not, that isn't what I am trying to do...I could never do that." +

+Then, I express my disagreement, and tell her: "That standard must be +our standard. If you are going to be a builder, no other standard is +worthwhile." +
+--Christopher Alexander, May 1996 in (Patterns of Software, Gabriel) +
+

Consider the best possible world. You've been hired at a company and join a team that is already working on a program. They hand you a book, diff --git a/src/axiom-website/patches.html b/src/axiom-website/patches.html index a3cc5ef..0d10bda 100644 --- a/src/axiom-website/patches.html +++ b/src/axiom-website/patches.html @@ -3696,5 +3696,7 @@ books/bookvol9 treeshake compiler
books/bookvolbib add additional references
20111124.04.tpd.patch books/bookvol9 treeshake compiler
+20111129.01.tpd.patch +src/axiom-website/litprog.html literate program example