From c841285edce26e0a6cfa4a04b358021afb363ecd Mon Sep 17 00:00:00 2001 From: km0 Date: Tue, 28 Feb 2023 22:36:08 +0100 Subject: [PATCH] fenced code --- chapters/00_intro.md | 7 ++++--- chapters/01_who_is_reading.md | 31 ++++++++++++------------------- chapters/03_hello_worlding.md | 4 ++-- 3 files changed, 18 insertions(+), 24 deletions(-) diff --git a/chapters/00_intro.md b/chapters/00_intro.md index b420033..117dc3f 100644 --- a/chapters/00_intro.md +++ b/chapters/00_intro.md @@ -1,11 +1,12 @@ ## Coding contingencies +``` TODO: - - how to quote propperly an introduction from a book series? (software studies) -- find where to put _code documentation_ & _developers_ paragraphs +- find where to put code documentation & developers paragraphs +- elaborate on citations +``` ---- How do you choose a particular programming language, a coding paradigm, a development environment, an infrastructure where to run the code, and so on? These are not just technical choices, but rather coding contingencies. diff --git a/chapters/01_who_is_reading.md b/chapters/01_who_is_reading.md index 6e75ce7..84906dd 100644 --- a/chapters/01_who_is_reading.md +++ b/chapters/01_who_is_reading.md @@ -1,6 +1,6 @@ ## Who is reading -` +``` documentation as a publishing surface? yes because @@ -10,7 +10,7 @@ yes because yes but it should be less hostile - see welcoming writing it should stop assuming reader - see natural readers -` +``` ### Getting started `("Getting startled" could also make for a nice title)` @@ -63,32 +63,25 @@ Programming means to deal with picky stubborn machines that don't overlook a sin Instead... - -- lowering barriers - - debugging (p5.js education working group, 2015) - - aesthetic programming - - welcome.js (bridle, 2016) - +``` +lowering barriers +- debugging (p5.js education working group, 2015) +- aesthetic programming +- welcome.js (bridle, 2016) +``` ## "Natural" reader +``` - assuming a certain kind of reader - expert - dude - references: - programming for the millions (ullman, 2016) - read the feminist manual (karagianni, 2021 ) - - bro culture ? ? ? (could be the transition from previous section) (could be the example with evvvvil help patches) - -vvvv is a visual programming language that offers an agile approach to prototyping, adoperated especially in the context of interaction design. It's focused on rapid and iterative work of fine tuning, necessary when dealing with real time inputs, such as sensors, live data, or human interaction. - -vvvv is a visual programming language -used esp with interaction design -fine tuning, iterative process -help patches - - refer to a specific cultural niche ? see ullman, even tho need to counter balance with other examples - - manuals often address just male developers - - often documentation doesn't offer entry points for beginners, or a sense of direction, this esp a problem with hypertexts +``` + +vvvv is a visual programming language that offers an agile approach to prototyping, adoperated especially in the context of interaction design. It's focused on rapid and iterative work of fine tuning, necessary when dealing with real time inputs, such as sensors, live data, or human interaction. diff --git a/chapters/03_hello_worlding.md b/chapters/03_hello_worlding.md index 14700f9..e5ad424 100644 --- a/chapters/03_hello_worlding.md +++ b/chapters/03_hello_worlding.md @@ -18,7 +18,7 @@ There could be several approaches for making worlds around software. Here are so These labels are open and loose, overlapping and not mutually exclusive, temporary and on the move. They are meant to change, to expire fast, and going bad even faster: they require continuous treatments and repeated efforts. That's why I'm naming them all after the _re_ prefix: to aknowledge their being in progress, second hand again, already contaminated. Borrowed by friends and foes, that had borrowed themselves from someone else. One should diffidate of these categories because they're instable. Nonetheless, they offer ways to visualize different strategies to create worlds around software. -` +``` reclaim take back reenchant intercept reassure keep going @@ -26,7 +26,7 @@ reassure keep going reclaim renegotiate, recuperate, remember, refuse, reactivate reenchant redirect, rebirth, reboot, rebrand, redeem reassure refrain, refresh, regret, reaffirm, register, readme -` +``` ### reclaim