todo

chap 4

• should it be about programming languages? or about programming semantics? or wait until i know really what it is about, and why it;s needed?

chap 3

• [ ] make it clear that we’re focusing on two sorts of knowledge: formal, or contextual.

meeting with nick 4.11.2022

• is it clear why i’m addressing definitions of understanding first, and then the actual object of understanding?
• is it more about understanding, or knowledge communication/knowledge reception?
• in general, i’m a bit unsure about how clear my approach to understanding is. i know it’s necessary to clarify what i mean, and the intent is to provide background for this “dual nature” of software.

meeting with nick

• [ ] pare down!
• • [ ] in the listings, extend the caption to show the relevance of the snippet (e.g. for listing 8, neither is said about APL or about Game of Life: how should readers know this is relevant?)
• • [ ] for stats comparing different software (windows2000, wp, kirby), use a chart to make the point much quicker
• • [ ] justify the comparison between win2000 and kirby (differences in size, date of creation)
• • [ ] also explain a bit more fast sqrt (greg walsh must have had a deep knowledge of ieee floating points standards)
• • [ ] fig. 10: original is color coded, but also too hard to comprehend. magmarize would be a better example
• • [ ] move listing 10 to understanding computers
• • [ ] one liner: monostiche
• • [ ] since the chapter is too long, paraphrase code, rather than quote it
• • [ ] listing #2, not style but voices
• • [ ] black perl is still in old mode
• • [ ] explain listing 13
• [ ] table of listings: this is what the work is about (variety, meaningful, captioned; the caption is also for me cause it shows i am able to express concisely why the example is there)

chap 1

• [ ] make the connection between abstract code beauty (the doxa) and the mathematical sublime of Kant
• [ ] a sentence or two on a fundamental connection between architecture and programming, related to how architecture must connect form and function as other arts are not required to do
• [ ] If you want to exhibit the difference between a (reasonably) high-level language, assembly, and machine code, you could contrive an example yourself by writing something very short in C and compiling it in gcc. The GNU Assembler, as, is what is used as part of the gcc toolchain, so if you were to write the corresponding assembly and confirm that it assembles to the same machine code … you have your example. And you might do it in a half-page of C, a similar amount of assembly, and 32 bytes of machine code.

general

• [ ] add all the refernces in the intro footnotes
• [ ] add pressman - software engineering: a practicioner’s approach
• [x] rewrite my definition of aesthetics to include more the aesthetics of everyday life?
  • [x] drawing from mckenzie, rewrite his part to include the fact that he puts a lot of lines of code in his book, but that it’s still a mostly social/anthropological interpretation of said code
  • [x] specify that the term software engineering appeared in 1968 at a conference [[wirth_history_software_engineering]]. but actually it’s fuzzy, some people say it was around 1967 src
• [x] ideals
  • [x] add the dope case study https://queue.acm.org/detail.cfm?id=1039535 also this http://denninginstitute.com/pjd/GP/gp_summary_toplevel.html
  • [x] re read hacker examples part to check for spoilers
  • [x] add research software engineers to data scientists https://www.nature.com/articles/d41586-022-01516-2
  • [x] tone down on methodology?
  • [x] add stats about corpus after methodology.
  • [x] add section on leslie vaillant in the elegance section https://dl.acm.org/doi/abs/10.1145/1953122.1953131
  • [x] add knuth details on elegance (see notes)
  • [x] add section on robin hill on elegance https://cacm.acm.org/blogs/blog-cacm/208547-what-makes-a-program-elegant/fulltext
  • [x] include some further discussion of programming based on hapoc 21 presentation
  • [ ] add a bit more meat to the section on scientific beauty
  • [ ] deal with frames and page breaks on minted; https://tex.stackexchange.com/questions/433192/breaking-pages-in-minted-package
  • [x] add “hacking perl” and live code in the artists section https://www.perl.com/pub/2004/08/31/livecode.html/
  • [x] everytime i quote SO, add the specifics of the survey details

~~look into the pdf “program text, style, laber” by brian lennon to address comments in microsoft windows source code~~

~~yullil - code art brutalism refers the HACKMEM document from 1972 MIT, related to architecture.~~

~~communautés épistémiques et communautés de pratique (Cohendet et al., 2001) -> Cohendet, Patrick, Creplet, Frederic & Dupouet, Olivier. « Organisational innovation, communities of practice and epistemic communities : the case of Linux ». In Economics with heterogeneous interacting agents~~