diff --git a/docs/daily/2021-02-04.org.gpg b/docs/daily/2021-02-04.org.gpg index 34be724..5fb0841 100644 Binary files a/docs/daily/2021-02-04.org.gpg and b/docs/daily/2021-02-04.org.gpg differ diff --git a/docs/notes/literate-programming.org.gpg b/docs/notes/literate-programming.org.gpg index 73e7070..5933876 100644 Binary files a/docs/notes/literate-programming.org.gpg and b/docs/notes/literate-programming.org.gpg differ diff --git a/website/content/notes/literate-programming.md b/website/content/notes/literate-programming.md index 008a043..0454a71 100644 --- a/website/content/notes/literate-programming.md +++ b/website/content/notes/literate-programming.md @@ -1,7 +1,7 @@ +++ title = "Literate Programming" author = ["Christopher James Hayward"] -lastmod = 2021-02-04T16:35:59-05:00 +lastmod = 2021-02-04T16:53:42-05:00 draft = false +++ @@ -16,24 +16,13 @@ Described in its introduction[^fn:1] as a > Programming paradigm in which a computer program is given an explanation of its logic in a natural language, such as English, interspersed with snippets of macros and traditional source code, from which compilable source code can be generated. -Knuth describes a **practitioner** in the introduction of his 1984 paper[^fn:1] as - -> An essayist concerned with exposition and excellence of style. Someone who carefully selects the name for each variable and describes their meaning. They will strive for a program that is comprehensible because concepts are introduced in a manner best for human understanding. - - -## Concept {#concept} - The overal concept is not to difficult to imagine: {{< figure src="/ox-hugo/literate-programming-concept.png" >}} -Illustrated above we see the process of **weaving** and **tangling** the literate source file, and how each of the produced components is handled respectively. +Knuth describes a **practitioner** in the introduction of his 1984 paper[^fn:1] as -| File | Description | -|------|------------------------------| -| org | Literate document / file | -| src | Machine readable source code | -| doc | Human readable documentation | +> An essayist concerned with exposition and excellence of style. Someone who carefully selects the name for each variable and describes their meaning. They will strive for a program that is comprehensible because concepts are introduced in a manner best for human understanding. ## Resources {#resources}