toad.social

screwlisp<a href="https://gamerplus.org/tags/programming" class="mention hashtag" rel="nofollow noopener" target="_blank">#programming</a> <a href="https://gamerplus.org/tags/systemsProgramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#systemsProgramming</a> <a href="https://gamerplus.org/tags/software" class="mention hashtag" rel="nofollow noopener" target="_blank">#software</a> <a href="https://gamerplus.org/tags/commonLisp" class="mention hashtag" rel="nofollow noopener" target="_blank">#commonLisp</a> <a href="https://gamerplus.org/tags/sitcalc" class="mention hashtag" rel="nofollow noopener" target="_blank">#sitcalc</a> <a href="https://gamerplus.org/tags/emacs" class="mention hashtag" rel="nofollow noopener" target="_blank">#emacs</a> <a href="https://gamerplus.org/tags/eepitch" class="mention hashtag" rel="nofollow noopener" target="_blank">#eepitch</a><a href="https://screwlisp.small-web.org/complex/my-eepitch-send-actions-and-the-situation-calculus/" rel="nofollow noopener" translate="no" target="_blank">https://screwlisp.small-web.org/complex/my-eepitch-send-actions-and-the-situation-calculus/</a>I relate <a href="https://gamerplus.org/tags/Sandewall" class="mention hashtag" rel="nofollow noopener" target="_blank">#Sandewall</a>'s call for situation calculus actions and the shared environment / database to be moved into the kernel viz my <a href="https://gamerplus.org/tags/literateProgramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#literateProgramming</a> emacs useage.People always said emacs /was/ the operatingsystem, didn't they.Particularly, computer programs various send requests for actions to the emacs server where they are also seen playing out at they actually happen in real time.

Vassil Nikolov> ... conversations with Knuth viz <a href="https://ieji.de/tags/literateProgramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#literateProgramming</a> or otherwise? Were you saying that it was specifically in the context of his book that web was important?Which book?<a href="https://gamerplus.org/@screwlisp" class="u-url mention" rel="nofollow noopener" target="_blank">@screwlisp</a> <a href="https://appdot.net/@mdhughes" class="u-url mention" rel="nofollow noopener" target="_blank">@mdhughes</a>

screwlisp<a href="https://appdot.net/@mdhughes" class="u-url mention" rel="nofollow noopener" target="_blank">@mdhughes</a> What were you sharing about your conversations with Knuth viz <a href="https://gamerplus.org/tags/literateProgramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#literateProgramming</a> or otherwise? Were you saying that it was specifically in the context of his book that web was important?The way eev resolves repl vs literate is that you only write in your literate document, and the repl updates on the other half of the screen without your cursor entering it.

screwlisp<a href="https://gamerplus.org/tags/lispyGopherClimate" class="mention hashtag" rel="nofollow noopener" target="_blank">#lispyGopherClimate</a> <a href="https://gamerplus.org/tags/comingUp" class="mention hashtag" rel="nofollow noopener" target="_blank">#comingUp</a> on <a href="https://anonradio.net" rel="nofollow noopener" translate="no" target="_blank">https://anonradio.net</a> 45 minutes from tooting.I'm just going to rhapsodise about my recent <a href="https://gamerplus.org/tags/literateProgramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#literateProgramming</a> <a href="https://gamerplus.org/tags/tangle" class="mention hashtag" rel="nofollow noopener" target="_blank">#tangle</a> <a href="https://screwlisp.small-web.org/programming/tangle" rel="nofollow noopener" translate="no" target="_blank">https://screwlisp.small-web.org/programming/tangle</a> <a href="https://gamerplus.org/tags/lisp" class="mention hashtag" rel="nofollow noopener" target="_blank">#lisp</a> program and my piece of like-a-human <a href="https://gamerplus.org/tags/eev" class="mention hashtag" rel="nofollow noopener" target="_blank">#eev</a> <a href="https://gamerplus.org/tags/emacs" class="mention hashtag" rel="nofollow noopener" target="_blank">#emacs</a> <a href="https://gamerplus.org/tags/commonlisp" class="mention hashtag" rel="nofollow noopener" target="_blank">#commonlisp</a> <a href="https://gamerplus.org/tags/swank" class="mention hashtag" rel="nofollow noopener" target="_blank">#swank</a> tooling <a href="https://screwlisp.small-web.org/screwniverse/cl-eepitch/" rel="nofollow noopener" translate="no" target="_blank">https://screwlisp.small-web.org/screwniverse/cl-eepitch/</a>And its relation to <a href="https://gamerplus.org/tags/softwareIndividuals" class="mention hashtag" rel="nofollow noopener" target="_blank">#softwareIndividuals</a>, control problems with <a href="https://gamerplus.org/tags/AI" class="mention hashtag" rel="nofollow noopener" target="_blank">#AI</a> as such.

screwlisp<a href="https://gamerplus.org/tags/programming" class="mention hashtag" rel="nofollow noopener" target="_blank">#programming</a> <a href="https://gamerplus.org/tags/softwareEngineering" class="mention hashtag" rel="nofollow noopener" target="_blank">#softwareEngineering</a> article <a href="https://screwlisp.small-web.org/programming/tangle/" rel="nofollow noopener" translate="no" target="_blank">https://screwlisp.small-web.org/programming/tangle/</a> <a href="https://gamerplus.org/tags/commonLisp" class="mention hashtag" rel="nofollow noopener" target="_blank">#commonLisp</a> <a href="https://gamerplus.org/tags/asdf" class="mention hashtag" rel="nofollow noopener" target="_blank">#asdf</a> <a href="https://gamerplus.org/tags/systemsProgramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#systemsProgramming</a> <a href="https://gamerplus.org/tags/series" class="mention hashtag" rel="nofollow noopener" target="_blank">#series</a> <a href="https://gamerplus.org/tags/pathnames" class="mention hashtag" rel="nofollow noopener" target="_blank">#pathnames</a> <a href="https://gamerplus.org/tags/packaging" class="mention hashtag" rel="nofollow noopener" target="_blank">#packaging</a> Really simple... Sort of... But so intricate to write. I deal with (writing a smidge of <a href="https://gamerplus.org/tags/interactive" class="mention hashtag" rel="nofollow noopener" target="_blank">#interactive</a> <a href="https://gamerplus.org/tags/lazyEvaluation" class="mention hashtag" rel="nofollow noopener" target="_blank">#lazyEvaluation</a> <a href="https://gamerplus.org/tags/functionalProgramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#functionalProgramming</a> ) :- Tangling markdown into an asdf :class :package-inferred-system lisp system - Doing so with scan-file and collect-file from series - Working with lisp’s make-pathname directories.<a href="https://gamerplus.org/tags/literateProgramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#literateProgramming</a>

PatI wrote a Literate Programming tool in AWK<a href="http://patpatpat.xyz/data/lit/lit.awk" rel="nofollow noopener" target="_blank">http://patpatpat.xyz/data/lit/lit.awk</a><a href="http://patpatpat.xyz/data/lit/example.html" rel="nofollow noopener" target="_blank">http://patpatpat.xyz/data/lit/example.html</a><a href="http://patpatpat.xyz/data/lit/example.lit" rel="nofollow noopener" target="_blank">http://patpatpat.xyz/data/lit/example.lit</a>I dogfooded the script: the page and the script itself are generated from a single literate file. The page hopefully explains my thought process. Its a tiny script but feels quite dense!(Feedback welcome)I like using AWK, there is something quite charming and fun about programming within the limitations of PATTERN + ACTION<a href="https://mastodon.sdf.org/tags/literateprogramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#literateprogramming</a> <a href="https://mastodon.sdf.org/tags/awk" class="mention hashtag" rel="nofollow noopener" target="_blank">#awk</a>

adamcrussellTo followup to my previous post this is the nuweb source for my <a href="https://mastodon.sdf.org/tags/Prolog" class="mention hashtag" rel="nofollow noopener" target="_blank">#Prolog</a> solutions to TWC 320.<a href="https://adamcrussell.livejournal.com/57668.html" rel="nofollow noopener" target="_blank">https://adamcrussell.livejournal.com/57668.html</a><a href="https://mastodon.sdf.org/tags/LiterateProgramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#LiterateProgramming</a>

Carlos Noceda RivaNew post about <a href="https://mastodon.social/tags/orgmode" class="mention hashtag" rel="nofollow noopener" target="_blank">#orgmode</a> <a href="https://mastodon.social/tags/orgbabel" class="mention hashtag" rel="nofollow noopener" target="_blank">#orgbabel</a> <a href="https://mastodon.social/tags/emacs" class="mention hashtag" rel="nofollow noopener" target="_blank">#emacs</a> and <a href="https://mastodon.social/tags/literateprogramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#literateprogramming</a> <a href="https://www.cnoceda.com/tecnologia/posts/20250412T072657--a-little-trick-in-my-literary-programming__babel_blog_emacs_tecnologia.html" rel="nofollow noopener" translate="no" target="_blank">https://www.cnoceda.com/tecnologia/posts/20250412T072657--a-little-trick-in-my-literary-programming__babel_blog_emacs_tecnologia.html</a>Is there another way to do this? Thanks in advance 🙂

aphex twinkI've been using the new <code>complete-preview-mode</code> instead of my usual <code>corfu</code> for completions for a few days now and i think i actually quite like it. i haven't even added any additional configuration for it yet, it works pretty fucking great out of the box! but, i realise it's time i sat and worked out some basic config for it and found a way to make it work such that matching curly braces in Hugo templates (in <code>HTML+</code> mode) work properly, atleast so that it doesn't add unnecessarily redundant closing braces. i still need to figure out how to make paired braces (and all the other paired symbols) work too. not sure these are mutually exclusive. I've not really found time off-late to work out these things so i guess what I'm asking for is help, lol. my literate config is available on my <a href="https://emacs.peregrinator.site/literate-emacs-configuration/" rel="nofollow noopener" target="_blank">website</a> and my <a href="https://git%20sr.ht/%7Eperegrinator/.emacs.d/" rel="nofollow noopener" target="_blank">Sourcehut</a> and any suggestions or fixes for these, you can either send an email to my <a href="https://lists.sr.ht/%7Eperegrinator/emacs" rel="nofollow noopener" target="_blank">mailing list</a> at ~peregrinator/emacs@lists.sr.ht or mention me here<a href="https://toot.cat/tags/Emacs" class="mention hashtag" rel="nofollow noopener" target="_blank">#Emacs</a> <a href="https://toot.cat/tags/LiterateProgramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#LiterateProgramming</a> <a href="https://toot.cat/tags/EmacsLiterateConfiguration" class="mention hashtag" rel="nofollow noopener" target="_blank">#EmacsLiterateConfiguration</a>

Nyan MaxComo sé que muchos lo estabais esperando (la verdad es que sé que nadie lo esperaba 😂) os dejo por aquí la segunda parte sobre EMACS + PROGRAMACIÓN LITERARIA. English version soon. <a href="gemini://maxxcan.flounder.online/informatica/emacs/articulos/2025-01-19-programacion-literaria-2.gmi" rel="nofollow noopener" translate="no" target="_blank">gemini://maxxcan.flounder.online/informatica/emacs/articulos/2025-01-19-programacion-literaria-2.gmi</a> y versión web: <a href="https://maxxcan.flounder.online/informatica/emacs/articulos/2025-01-19-programacion-literaria-2.gmi" rel="nofollow noopener" translate="no" target="_blank">https://maxxcan.flounder.online/informatica/emacs/articulos/2025-01-19-programacion-literaria-2.gmi</a> <a href="https://mastodon.social/tags/emacs" class="mention hashtag" rel="nofollow noopener" target="_blank">#emacs</a> <a href="https://mastodon.social/tags/literateprogramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#literateprogramming</a> <a href="https://mastodon.social/tags/babel" class="mention hashtag" rel="nofollow noopener" target="_blank">#babel</a> <a href="https://mastodon.social/tags/orgmode" class="mention hashtag" rel="nofollow noopener" target="_blank">#orgmode</a> <a href="https://social.sachachua.com/@sacha" class="u-url mention" rel="nofollow noopener" target="_blank">@sacha</a> <a href="https://fosstodon.org/@hispaemacs" class="u-url mention" rel="nofollow noopener" target="_blank">@hispaemacs</a>

Karl Voit :emacs: :orgmode:<a href="https://fediscience.org/@ericsfraga" class="u-url mention" rel="nofollow noopener" target="_blank">@ericsfraga</a> In 2012, Thomas S. Dye and I did a demo project that generated an <a href="https://graz.social/tags/ACM" class="mention hashtag" rel="nofollow noopener" target="_blank">#ACM</a> paper with all algorithms used in one single <a href="https://graz.social/tags/orgmode" class="mention hashtag" rel="nofollow noopener" target="_blank">#orgmode</a> file:<a href="https://github.com/novoid/orgmode-iKNOW2012" rel="nofollow noopener" translate="no" target="_blank">https://github.com/novoid/orgmode-iKNOW2012</a>Would most probably need some updates I guess.<a href="https://graz.social/tags/reproducibility" class="mention hashtag" rel="nofollow noopener" target="_blank">#reproducibility</a> <a href="https://graz.social/tags/ReproducibleResearch" class="mention hashtag" rel="nofollow noopener" target="_blank">#ReproducibleResearch</a> <a href="https://graz.social/tags/openscience" class="mention hashtag" rel="nofollow noopener" target="_blank">#openscience</a> <a href="https://graz.social/tags/paper" class="mention hashtag" rel="nofollow noopener" target="_blank">#paper</a> <a href="https://graz.social/tags/iKnow" class="mention hashtag" rel="nofollow noopener" target="_blank">#iKnow</a> <a href="https://graz.social/tags/literateprogramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#literateprogramming</a> <a href="https://graz.social/tags/opendata" class="mention hashtag" rel="nofollow noopener" target="_blank">#opendata</a> <a href="https://graz.social/tags/Emacs" class="mention hashtag" rel="nofollow noopener" target="_blank">#Emacs</a>

Paolo AmorosoWolfgang Faust on why the evolution of programming languages made specialized literate programming tools less necessary, and how modern languages support literate programming techniques.<a href="https://www.linestarve.com/blog/post/literate-programming-untangled/" rel="nofollow noopener" translate="no" target="_blank">https://www.linestarve.com/blog/post/literate-programming-untangled/</a><a href="https://fosstodon.org/tags/LiterateProgramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#LiterateProgramming</a> <a href="https://fosstodon.org/tags/documentation" class="mention hashtag" rel="nofollow noopener" target="_blank">#documentation</a> <a href="https://fosstodon.org/tags/programming" class="mention hashtag" rel="nofollow noopener" target="_blank">#programming</a>

(((@amarois)))[ToRead] M. Le Béchec ; C. Gruson-Daniel ; C. Lascombes ; É. Schultz - Notebook and Open science: toward more FAIR play jdmdh:13428-Journal of Data Mining & Digital Humanities, 16 déc. 2024, Atelier Digit\_Hum=> <a href="https://doi.org/10.46298/jdmdh.13428" rel="nofollow noopener" translate="no" target="_blank">https://doi.org/10.46298/jdmdh.13428</a> <a href="https://mamot.fr/tags/FAIRprinciples" class="mention hashtag" rel="nofollow noopener" target="_blank">#FAIRprinciples</a> <a href="https://mamot.fr/tags/openscience" class="mention hashtag" rel="nofollow noopener" target="_blank">#openscience</a> <a href="https://mamot.fr/tags/notebooks" class="mention hashtag" rel="nofollow noopener" target="_blank">#notebooks</a> <a href="https://mamot.fr/tags/literateprogramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#literateprogramming</a> <a href="https://mamot.fr/tags/DH" class="mention hashtag" rel="nofollow noopener" target="_blank">#DH</a>

Csepp 🌢Does <a href="https://merveilles.town/tags/Jupyter" class="mention hashtag" rel="nofollow noopener" target="_blank">#Jupyter</a> count as a <a href="https://merveilles.town/tags/literateProgramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#literateProgramming</a> environment? :flan_think:

Ramesh #NotGoingBack⬆️ <a href="https://mastodon.social/@palmin" class="u-url mention" rel="nofollow noopener" target="_blank">@palmin</a> Interesting juxtaposition of <a href="https://mastodon.social/tags/Sudoku" class="mention hashtag" rel="nofollow noopener" target="_blank">#Sudoku</a> and <a href="https://mastodon.social/tags/Knuth" class="mention hashtag" rel="nofollow noopener" target="_blank">#Knuth</a>. Remarkable how the order is completely reversed in the modern programmers' <a href="https://mastodon.social/tags/hierarchyOfNeeds" class="mention hashtag" rel="nofollow noopener" target="_blank">#hierarchyOfNeeds</a> —1. Get paid for computer programming2. Even make your programs do useful work — May be sudoku grid from a dependency graph qualifies3. Embrace <a href="https://mastodon.social/tags/LiterateProgramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#LiterateProgramming</a> —Make well-written programs FUN to read. No <a href="https://mastodon.social/tags/TeXLaTeX" class="mention hashtag" rel="nofollow noopener" target="_blank">#TeXLaTeX</a>, but my <a href="https://mastodon.social/tags/Swift" class="mention hashtag" rel="nofollow noopener" target="_blank">#Swift</a> toolchain does supports <a href="https://mastodon.social/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#Markdown</a> in code comments to capture joy for posterity<a href="https://www-cs-faculty.stanford.edu/~knuth/lp.html" rel="nofollow noopener" translate="no" target="_blank">https://www-cs-faculty.stanford.edu/~knuth/lp.html</a>

Giuseppe BilottaI've just tagged and released a new minor release (v2.3) of my <a href="https://fediscience.org/tags/Asciidoctor" class="mention hashtag" rel="nofollow noopener" target="_blank">#Asciidoctor</a> extension for <a href="https://fediscience.org/tags/LiterateProgramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#LiterateProgramming</a> <a href="https://github.com/Oblomov/asciidoctor-litprog" rel="nofollow noopener" translate="no" target="_blank">https://github.com/Oblomov/asciidoctor-litprog</a>I was actually in doubt if it should be considered a minor or major release, since there are some rather extensive changes and some new features, such as the possibility to output a graph of the chunk inclusion/dependency tree in <a href="https://fediscience.org/tags/DOT" class="mention hashtag" rel="nofollow noopener" target="_blank">#DOT</a> format.

Karsten SchmidtSome more info & illustration of the lens axis used above (excerpt from the <a href="https://mastodon.thi.ng/tags/LiterateProgramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#LiterateProgramming</a> source code of the much older <a href="https://mastodon.thi.ng/tags/Clojure" class="mention hashtag" rel="nofollow noopener" target="_blank">#Clojure</a> version of <a href="https://thi.ng/viz" rel="nofollow noopener" translate="no" target="_blank">https://thi.ng/viz</a>)This axis type uses circular interpolation to create the non-linear mapping: <a href="https://docs.thi.ng/umbrella/math/functions/lens.html" rel="nofollow noopener" translate="no" target="_blank">https://docs.thi.ng/umbrella/math/functions/lens.html</a>There will also be an alternative/similar version using the generalized Schlick formula: <a href="https://docs.thi.ng/umbrella/math/functions/schlick.html" rel="nofollow noopener" translate="no" target="_blank">https://docs.thi.ng/umbrella/math/functions/schlick.html</a>Source code link of the animation below: <a href="https://github.com/thi-ng/geom/blob/feature/no-org/org/src/viz/core.org#lens-scale-dilating--bundling" rel="nofollow noopener" translate="no" target="_blank">https://github.com/thi-ng/geom/blob/feature/no-org/org/src/viz/core.org#lens-scale-dilating--bundling</a><a href="https://mastodon.thi.ng/tags/DataViz" class="mention hashtag" rel="nofollow noopener" target="_blank">#DataViz</a> <a href="https://mastodon.thi.ng/tags/Visualization" class="mention hashtag" rel="nofollow noopener" target="_blank">#Visualization</a> <a href="https://mastodon.thi.ng/tags/NonLinear" class="mention hashtag" rel="nofollow noopener" target="_blank">#NonLinear</a>

Karsten SchmidtRather than considering even just once the needs & massive benefits for creators and maintainers, current open source software infrastructure, support tools, but also developer culture itself is completely biased and optimized purely for the benefit of consumers/users. Choosing a non-standard project structure (in my case a mature Google-style monorepo with almost 200 largely independent, but related projects/libraries/tools) is increasingly actively punishing my work and efforts in a variety of ways, e.g.- non-supportive UIs for improved browsing/overviews of monorepos - harmed discovery via search & metadata limitations - wrong, misleading and downgraded project ranking calculations (npm) - misleading/broken automated project analysis (GitHub) - lack of support by documentation tooling (TypeDoc) - lack of support by package managers (Zig) and/or hosting platformsAll of these (and more) factors are actively hurting, disqualifying & even completely nullifying much of my time & energy spent on these projects, making my dream goal of working on open source fulltime increasingly intangible (because the above factors all have an actively downgrading effect which makes these project seem lower quality/relevance). To some extent this is purely because this work is stored in a project structure which is optimized for maintenance & automation. Technically, we're speaking about _one_ additional level of nesting. An extra subdirectory! Otherwise, not any different than a "normal" repo. Still — BOOM — confusion, inflexibility & punishment ensues! 😫😭So many external aspects and people do not give a damn that a monorepo setup like this and the custom tooling created to automate the maintainance and cross-linking of all these ~360 packages (incl. example projects) are _the only sane way_ for me as a single person to efficiently manage & release a codebase of this magnitude.I was aware of some misunderstandings about monorepos on purely social/human level, but never saw it coming that the more I was expanding and deepening this work, the more this structure and scope would hurt the project & my goals, because 3rd party infrastructure is just as weirded out by such a "blasphemy" as some people are...I'd genuinely like to hear ideas what I could/should do to escape the vicious circle created by the above factors, which is a real motivation killer... I really do wonder how other maintainers (esp. would like to hear from indie devs) handle projects & codebases of this scale without running into these issues...Thank you for any insights!Ps. I really seem to have a feeble for "think different" and going against the grain with these things (or maybe being too early?). The first set of 20+ <a href="https://thi.ng" rel="nofollow noopener" translate="no" target="_blank">https://thi.ng</a> libraries for Clojure/ClojureScript were mostly written in a <a href="https://mastodon.thi.ng/tags/LiterateProgramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#LiterateProgramming</a> format, often combining source code with diagrams & tables — this too led to many complaints and was partially to blame for not gaining much traction, even though these projects were singular offerings to that language community at the time (and funnily only became more popular _after_ 6-7 years, once I'd already left Clojure behind... go figure!)<a href="https://mastodon.thi.ng/tags/OpenSource" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenSource</a> <a href="https://mastodon.thi.ng/tags/MonoRepo" class="mention hashtag" rel="nofollow noopener" target="_blank">#MonoRepo</a> <a href="https://mastodon.thi.ng/tags/Maintainance" class="mention hashtag" rel="nofollow noopener" target="_blank">#Maintainance</a> <a href="https://mastodon.thi.ng/tags/Infrastructure" class="mention hashtag" rel="nofollow noopener" target="_blank">#Infrastructure</a> <a href="https://mastodon.thi.ng/tags/Documentation" class="mention hashtag" rel="nofollow noopener" target="_blank">#Documentation</a> <a href="https://mastodon.thi.ng/tags/Tooling" class="mention hashtag" rel="nofollow noopener" target="_blank">#Tooling</a> <a href="https://mastodon.thi.ng/tags/SocialCoding" class="mention hashtag" rel="nofollow noopener" target="_blank">#SocialCoding</a> <a href="https://mastodon.thi.ng/tags/Expectations" class="mention hashtag" rel="nofollow noopener" target="_blank">#Expectations</a> <a href="https://mastodon.thi.ng/tags/NonStandard" class="mention hashtag" rel="nofollow noopener" target="_blank">#NonStandard</a>

Alex NelsonI've written everything I've learned about "literate programming" (in Knuth's sense) over the past few years.The short answer is: we don't know how to do it, there are few good examples, and all the advice/guidance given turns out to be mutually contradictory.The method Knuth endorses is to do more top-down design, just as when drawing you do quick sketches, filling in more and more as you cycle through the program.But the best literate program I've ever seen is "Crafting Interpreters" by Bob Nystrom, which takes the exact opposite approach: write the code and write an outline (namely, the chapters and topics discussed in each chapter), then rewrite the code, reorder the chapters and material, and only once that has been finished...write prose.There is no royal road to literate programming, it seems. If you want to write well, it requires a lot of experimentation and failing (like graphic design). <a href="https://mathstodon.xyz/tags/literateprogramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#literateprogramming</a> <a href="https://pqnelson.github.io/2024/05/29/literate-programming.html" rel="nofollow noopener" translate="no" target="_blank">https://pqnelson.github.io/2024/05/29/literate-programming.html</a>

Life is TetrisI was wondering if comments alongside source code are not read for reasons other than them being likely to be out of date. Maybe its because ... syntax highlighting makes them less readable?<a href="https://qoto.org/tags/SoftwareDevelopment" class="mention hashtag" rel="nofollow noopener" target="_blank">#SoftwareDevelopment</a> <a href="https://qoto.org/tags/Documentation" class="mention hashtag" rel="nofollow noopener" target="_blank">#Documentation</a> <a href="https://qoto.org/tags/LiterateProgramming" class="mention hashtag" rel="nofollow noopener" target="_blank">#LiterateProgramming</a>

Recent searches

Search options

Administered by:

Server stats:

#literateprogramming