Why isn't literate programming mainstream?
Coders write code not English.
Programmers do not such as creating documents due to the fact that it does not aid the code run.
Programmers aren't efficient creating documents due to the fact that its an inadequate tool to share their suggestions.
Literate programming appears to be the suggestion of taking documents to the next degree where the code is even more of an after - idea. Possibly it would certainly function, yet to most coder it resembles ridiculous documents.
In my modest point of views, several firms have a society that is the contrary to the purposes of Literate Programming: they desire faster outcomes (they just sob concerning top quality when the application remains in manufacturing). In my very own experience, my employers had refuse to recognize that faster outcomes does not suggest "a program runnable the day after I requesting for." For them, if a programmer isn't active keying over his key-board, he isn't functioning, is "losing his time in layout - non - feeling". Yes, I recognize, my employer is an arsehole.
I first saw it in a publication of Knuth is works, and also assumed it looked cool. After that I attempted to make use of the literary shows display screen to understand what was taking place in the program, and also located it tougher than it looked. It might have been that I was also made use of to experiencing program listings, yet it appeared perplexing.
After that I considered the resource code, which transformed me off after that and also there. I would certainly need to find out to write programs in a totally new means, with much less document in between the program message and also what the compiler saw, and also saw no equivalent advantage.
On top of that, individuals can write lengthy and also persuading debates that the code is doing X when it is in fact doing Y, and also I've faced my share of deceptive remarks. I created a desire for reviewing the code to see what it is doing rather early. Literate programming is the reverse of that.
I would certainly condemn the network effect. For other individuals to modify your code and also documents, they have to have the ability to recognize it.
This presses individuals far from something like cweb/noweb, due to the fact that utilizing them would certainly need you to find out TeX and also the program - details syntax in addition to the shows language you are making use of for the task. This can be viewed as a massive wild-goose chase, specifically if they do not require any one of the mathematics typesetting that is such a large draw for TeX to begin with. (And for several applications designers, they actually will not require it.) Rather they favor something like Visual Studio's XML remarks, since that's currently preferred and also well - developed.
The areas I have actually seen literate programming remove remain in scientific/statistical computer, where a lot of the designers have substantial training (also known as PhDs) in mathematics, CS, or data, and also hence are currently famliiar with LaTeX. The documents they write is more probable to include a great deal of difficult solutions that are best created in TeX, and also they are more probable to be setting in R. The percentage of R designers that find out about SWeave is most definitely a lot greater than, claim, the percentage of C designers that find out about cweb.