5 ms·
I've done a few projects using literate programming, a couple of which were fairly large for a single developer. If you use noweb, it doesn't care about the la
by AndrewOMartin 6y ago
I've done a few projects using literate programming, a couple of which were fairly large for a single developer.
If you use noweb, it doesn't care about the language you use. You can even have a section in the document which contains chunks of code in different languages and how they interact. For example, one chunk could be a part of the render function of a React component, the next chunk could be the Flask API endpoint which generates the data displayed by the component.
Literate programming has its problems, and it is made less necessary with modern languages and tools, but I've repeatedly had the experience where it was LP that allowed me to return to a project after a few months and know exactly what was going on and where to continue.
- AndrewOMartin 6y agoMy earlier post inspired me to push one of my Literate Programming, if inauspicious, projects to my public github. https://github.com/AndrewOwenMartin/nestor https://github.com/AndrewOwenMartin/nestor This repo implements an all-but-unknown ANN called NESTOR, but you can use it as an example of how it would be relatively easy for someone who knows nothing (or has forgotten everything) about NESTOR to contribute to the project. I make no claims that it is a good example of such.