{"id":10792,"date":"2022-09-07T14:31:40","date_gmt":"2022-09-07T18:31:40","guid":{"rendered":"https:\/\/irreal.org\/blog\/?p=10792"},"modified":"2022-09-07T14:31:40","modified_gmt":"2022-09-07T18:31:40","slug":"john-cook-on-literate-programming","status":"publish","type":"post","link":"https:\/\/irreal.org\/blog\/?p=10792","title":{"rendered":"John Cook on Literate Programming"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">John D. Cook has another post in his series of posts discussing the use of Org mode in his professional duties as a consulting mathematician. This time he discusses <a href=\"https:\/\/www.johndcook.com\/blog\/2022\/09\/05\/literate-programming\/\">the pros and cons of literate programming<\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">He recounts the story of a blog post that had some errors that he believes might have been avoided if he\u2019d used literate programming. He rewrote the post using literate programming and had a few observations.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">First, he found that it was harder to compose the post using literate programming. There\u2019s a lot of little markup details that you have to deal with that aren\u2019t necessary when you just paste in a value from a separate computation. Still, that effort pays dividends if you have to update your post with new parameters and can help reduce errors.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">I\u2019ve reached the point where I do all my writing in Org-mode and <em>always<\/em> do any necessary computations in a code block. It\u2019s a real win because if parameters change I just need to change it in one place and regenerate the document and I don\u2019t need to worry about errors induced by pasting in values.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Take a look at Cook\u2019s post for the point of view of someone who, although technical, is not really part of the developer community.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>John D. Cook has another post in his series of posts discussing the use of Org mode in his professional duties as a consulting mathematician. This time he discusses the pros and cons of literate programming. He recounts the story &hellip; <a href=\"https:\/\/irreal.org\/blog\/?p=10792\">Continue reading <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[5],"tags":[18,4],"class_list":["post-10792","post","type-post","status-publish","format-standard","hentry","category-general","tag-emacs","tag-org-mode"],"_links":{"self":[{"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/posts\/10792","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=10792"}],"version-history":[{"count":1,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/posts\/10792\/revisions"}],"predecessor-version":[{"id":10793,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/posts\/10792\/revisions\/10793"}],"wp:attachment":[{"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=10792"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=10792"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=10792"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}