thesis/notes.md

Notes to the self

-2 days todo list

[x] transition to getting startled from entry point to backdoor [x] example paragraph padliography situate within larger context [x] and maybe connect it to aesthetic programming [x] outro code companion wrap up [x] outro [ ] context soupboat in appendix / situated docs? [ ] readme in appendix / situated docs [x] hello worlding: code documentation as an entry point / backdoor to programming practices

[ ] cover & word count [x] grammar [ ] toc

first chap structure

consider to readjust a bit the structure of first chapter, swapping things in order to have issues at the beginning and approaches and methods at the end

for example diataxis could be introduced after exposing all the other problems and link better with the idea of backdoor with the idea of code companion and the fact that is read both by beginners and experienced ones

structure:

1. Entry points Researching languages, formats and approaches of code documentation to broaden participation in the making of software

   1. Natural readers
   2. Welcoming writing
   3. Docs as gardening
   4. Getting startled
   5. Code companion

2. Backdoors Exploring and stretching coding contingencies with code documentation practices

   1. Politics of participation
   2. Politics of representation
   3. Aesthetic practices

tutorial with Cristina 29/03

Things to talk about:

• recap documentation session

• next session ?

• sister server 360 degrees for thesis

• queer motto api for thesis

• documentation archive + tag system inspired by the sessions

• it's moment to start thinking to which kind of surface, which kind of participation

for Jian

• https://mermaid.js.org
• https://asciiflow.com/

Tutorial with Cristina, lecture with Aymeric

• lack of documentation is (not) the only problem
• documentation as gardening, need for constant maintainance
• see refs in the queque
• look into gemini protocol for documentation
• garden library network
• print a small photo receipt roll for Marloes
• cultural diffusion vs cultural appropriation
• tower of babel of technicalities

Aaaaaaaaaaaaaaaaaaaaaaaaaa

For research question: developing and sharing tools is important so mention it

Cycling along the river

• notes for thesis: cycling along the river, documentation, learning a new language, esolang, exploring different ways of thinking

Revision on structure and late night notes

• new intro
• two flows
• (chap 02) from close to the mainframe to telescopic writing

Bouldering and secrecy

• suckless and bouldering: different levels of documentation

• documentation as backdoor --> but for a different target

• stealth

• cave paintings

Plan for first draft deadline (20/02/2023)

• intro good
• first chapter 60% good 40% outline
• second & third chapters outline and refs
• update readme.md

9/02 Buddies session with Alex & Marloes

• Intro:
  • define that we are talking about code documentation
  • define who is addressed when we say "developer"
  • explicit structure of the chapters for last three paragraphs

Old notes

• be a mean to explore these contingencies?

  • coding contingencies
  • software studies
  • documentation to address issues
    1. Welcoming diverse knowledges
    2. Lowering barriers and create entry points
    3. Orientate software in the world
  • practical example!!!

• be an interface between different knowledges?

  • interface between code, developer, world
  • post meritocracy manifesto
  • trans*femminist server whishlist

• be an ideal surface to build worlds?

  • the screenless office
  • ian cheng

• be a device to trigger different kinds of economy around situated software?

  • 360 degrees of proximity