Literate Programming (LP)
Literate programming is the practice of structured documentation where the primary narrative is human-oriented, and the source code is embedded within it (tangled).
The Philosophy
Traditional programming treats comments as secondary to the code. Literate programming inverts this relationship: the code is an artifact of the explanation.
In the Dev-Centr ecosystem, we endorse Synchronous Literate Programming (SLP). This moves beyond traditional batch-processing (Tangle/Weave) into a Unified AST model where the document and the code are synchronized in real-time.
Why LP is the Correct Way to Program
-
Intent-First: It forces the developer to explain why something is being done before how it is implemented.
-
Evolutionary Modeling: LP allows for documenting the transformation of a simple idea into a complex module, providing a "narrative arc" for the codebase.
-
AI Synergy: LLMs and coding agents perform significantly better when provided with the rich contextual narrative surrounding the code, rather than just raw source and sparse comments.