254 karma · joined April 25, 2014
It works well for personal stuff where you would like to leave some bits of information for yourself (typically, configuration files).
It works well for small libraries where good documentation is important.
It works well for visualisation-work, where you may combine multiple languages and data-formats without writing API's for each.
In larger scale apps though and with collaboration; you run into problems with tooling on multiple levels. I am working on tackling scale, but collaboration is tricky. Mostly because you need structure to collaborate and then you will likely end up with an outline that's pretty close to a directory-tree and then you've lost one of the good bits of literate code in my opinion.
To add to my suspicion. A month or so ago, I was running Big Sur beta and was asked to give a system service from Google, admin access and restart. That in turn broke my Mac, so I had to spend hours to get back up and running. Why does the service require admin-access? Why did it require me to restart my computer?
From Evan's comment, I think he would like you to pick up the discussion and provide some more food for thought.
I'm sure the community would also like to hear about the other issues your encountering as well. I, for one, would.