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
92
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…
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,672
  • 5
  • 42
  • 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,647
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,437