You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
123 lines
3.3 KiB
Markdown
123 lines
3.3 KiB
Markdown
# Notes to the self
|
|
|
|
|
|
|
|
## 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
|