diff --git a/projects/gpp/gpp.md b/projects/gpp/gpp.md index 8604c95..025e8e4 100644 --- a/projects/gpp/gpp.md +++ b/projects/gpp/gpp.md @@ -13,7 +13,7 @@ title: Situated Docs ## What do you want to make? -Compile a list of resources to explore the _documentation of coding related practices_ from a community-based perspective, as a process of sharing knowledge and making worlds together around _situated software_. +Compile a list of resources to explore the _documentation of coding related practices_ from a community-oriented perspective, as a process of sharing knowledge and making worlds together around _situated software_. To work within the constraints of a structure such as the list will help to think through the complexity of dealing with a double _unknown_: the one of software and the one of situatedness. This complexity will hopefully be preserved and encoded in the relations between different items. diff --git a/projects/take-away/river.jpg b/projects/take-away/river.jpg new file mode 100644 index 0000000..09c6dce Binary files /dev/null and b/projects/take-away/river.jpg differ diff --git a/projects/take-away/take-away.md b/projects/take-away/take-away.md index beb3b82..9e0de49 100644 --- a/projects/take-away/take-away.md +++ b/projects/take-away/take-away.md @@ -15,12 +15,13 @@ cover_alt: tannuki tanuki tanuki tanuki - the surface is A3 2 sides - ideas: - - blueprint for the thesis writing machine. use the a3 fanzine to plan and reflect on the features and needs for that + - blueprint for the thesis writing machine. use the a3 fanzine to plan and reflect on the features and needs - as a way to document it beforehand ( to worlding around ) - enchanting the software - - source things to insert in the code as lucky charm from ppl ahah !! + - source things to insert in the code as lucky charm from ppl ahah !! - provide starting points for the list - - could be manga based ah ah or maybe not + +Some prompts: ![a spiral](spiral.jpg) the making of software in a spiral @@ -29,10 +30,49 @@ the making of software in a spiral - with all the other actors spiraling around - one can get into the making of software from a distance - size of the spiral is related to: the distance from the source code -- documentation is following the spiral backward? +- documentation is following the spiral - distance from the center is related to specificity - more distant, less technical - try to map the doc system on the spiral? ![LAMP](lamp.jpg) -the making of software is a lamp +Software is a lamp + +- software is a lamp +- documentation is the light +- you can see the lamp if the light is lit +- if it's not lit the lamp is there but you cannot see +- can you use other lights to see the lamp? +- + +What about these prompts? They are a way to think about documentation systems and the making of software. + +![river](river.jpg) +Software is a river + +- How to structure the thesis writing machine ? +- Which level of granularity ? +- I would like to work with small text files +- but then the parsing could be trublesome ? +- small frontmatter files ? +- every entry of the list is a different file ? +- that is crazy, it would be much better to work with a DB +- but the db is obscure and requires CRUD +- that is not a problem... +- but i would prefer to have the files with the text thereeee +- writing the thesis in git +- git writing workflow +- wait also true that the thesis and the project are two different things +- but still +- everything is a file? +- + +## Topological thinking + +- A3 double side: it means: 2 A3 or 4 A4 +- 2 A3 means 1 A3 to provide context 1 A3 to provide a starting point for this +- context: + - situated doc -------> excerpts from the proj prop, framed in an accessible way (the outside of the spiral) + - + +context from the pro pro: