Questions tagged [literate-programming]

Literate programming is an approach to programming introduced by Donald Knuth as an alternative to the structured programming paradigm of the 1970s. The paradigm represents a move away from writing programs in the manner and order imposed by the computer, and towards the programmers' logic and flow of their thoughts.

Resources

5 questions
93
votes
12 answers

Is there a reason that tests aren't written inline with the code that they test?

I've been reading a bit about Literate Programming recently, and it got me thinking... Well-written tests, especially BDD-style specs can do a better job at explaining what code does than prose does, and have the big advantage of verifying their own…
Chris Devereux
  • 931
  • 2
  • 7
  • 9
34
votes
12 answers

Why isn't literate programming mainstream?

Literate programming has good ideals. Why do you think that this isn't mainstream? It is because it has failed to deliver?
Casebash
  • 7,662
  • 5
  • 41
  • 62
10
votes
4 answers

Literate programming, good/bad design methodology

I have recently found the concept of literate programming. And I found it rather intriguing. Yet I have not been encountered with claims that it is a bad way to structure a program. It seems not covered many places. Not even here could I find any…
9
votes
3 answers

What is the connection between literate programming and the semantic web?

I was (casually) researching semantic / ontology based approaches to technical documentation, when I stumbled upon this gem: Literate Programming and the Semantic Web are ideas from different times, which do have a connection. The linked paper,…
yannis
  • 39,547
  • 40
  • 183
  • 216
6
votes
2 answers

Executable documentation

I like asciidoc, resp. asciidoctor, for documentation purposes. It is way better than MS Word and integrates better with source control compared to tools like Confluence. Furthermore, I am aware of tools, which allow you to write executable parts…
Frank
  • 14,407
  • 3
  • 41
  • 66