Great post discussing the weaknesses of literate programming: https://akkartik.name/post/literate-programming