|
|
|
@ -194,7 +194,7 @@
|
|
|
|
- _internal public_
|
|
|
|
- _internal public_
|
|
|
|
- that would be us
|
|
|
|
- that would be us
|
|
|
|
- offer a way to keep track
|
|
|
|
- offer a way to keep track
|
|
|
|
- and orientate knowledge
|
|
|
|
- orientate knowledge
|
|
|
|
- share a common interface
|
|
|
|
- share a common interface
|
|
|
|
- _external public_
|
|
|
|
- _external public_
|
|
|
|
- a way to navigate the Soupboat
|
|
|
|
- a way to navigate the Soupboat
|
|
|
|
@ -203,43 +203,96 @@
|
|
|
|
<br>
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
|
|
- _framework_
|
|
|
|
- _framework_
|
|
|
|
|
|
|
|
- could a [standard documentation framework](https://diataxis.fr/) work for us?
|
|
|
|
|
|
|
|
- not sure!
|
|
|
|
|
|
|
|
- our software are situated in specific contexts
|
|
|
|
|
|
|
|
- and contexts are different one from another
|
|
|
|
|
|
|
|
- there is not a _single_ _simple_ _smart_ solution™
|
|
|
|
|
|
|
|
- no one size fits all
|
|
|
|
|
|
|
|
- what is there though are some common features
|
|
|
|
|
|
|
|
- small scale and tempo
|
|
|
|
|
|
|
|
- a sociality around software
|
|
|
|
|
|
|
|
- an economy of different knowledges
|
|
|
|
|
|
|
|
- so the plan is research through these aspect
|
|
|
|
|
|
|
|
- and curate a list of resources
|
|
|
|
|
|
|
|
- a framework
|
|
|
|
|
|
|
|
- to navigate this network of networks
|
|
|
|
|
|
|
|
- with the process of documentation
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
|
|
- **a system of software & practices**
|
|
|
|
- **a system of software & practices**
|
|
|
|
- shared surface or interface
|
|
|
|
- a list of
|
|
|
|
|
|
|
|
- _references_
|
|
|
|
|
|
|
|
- _tools_
|
|
|
|
|
|
|
|
- _devices_
|
|
|
|
|
|
|
|
- _thoughts_
|
|
|
|
|
|
|
|
- _excercises_
|
|
|
|
|
|
|
|
- _hints_
|
|
|
|
|
|
|
|
- _fieldwork_
|
|
|
|
|
|
|
|
- to articulate software documentation as a form of care
|
|
|
|
|
|
|
|
- without claim to catch everything
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- shared surface
|
|
|
|
- one sentence games ritual
|
|
|
|
- one sentence games ritual
|
|
|
|
- the breakfast club
|
|
|
|
- the breakfast club
|
|
|
|
- flexible and expressive enough
|
|
|
|
- flexible and expressive enough
|
|
|
|
- to be useful for us
|
|
|
|
- to be useful for us
|
|
|
|
- and accessible for others
|
|
|
|
- and accessible for others
|
|
|
|
- a list of resources
|
|
|
|
|
|
|
|
- tools
|
|
|
|
|
|
|
|
- references
|
|
|
|
|
|
|
|
- strategies
|
|
|
|
|
|
|
|
- entry points
|
|
|
|
|
|
|
|
- to articulate code as common
|
|
|
|
|
|
|
|
- and documentation as a form of care
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
|
|
- and this is maybe the moment for a small demo???
|
|
|
|
- and this is maybe the moment for a small demo???
|
|
|
|
- flat markup bonfire
|
|
|
|
- [flat markup bonfire](/soupboat/bonfire/)
|
|
|
|
- show don't tell
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
|
|
- **the plan**
|
|
|
|
- **the plan**
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
|
|
- **first 3 months** passed experimenting with documentation
|
|
|
|
- **first 3 months** passed experimenting with documentation
|
|
|
|
- the **next 3 months** are focused on the _internal public_
|
|
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- the **next 3 months** are focused on
|
|
|
|
|
|
|
|
- _internal public_
|
|
|
|
- here i see myself as facilitator
|
|
|
|
- here i see myself as facilitator
|
|
|
|
- introducing the framework
|
|
|
|
- introducing the framework
|
|
|
|
- january is for prototyping small frameworks
|
|
|
|
- january is for offering them to the group
|
|
|
|
- february is for offering them to the group
|
|
|
|
- februray is for prototyping software & practice
|
|
|
|
- march is for using the framework to index the Soupboat
|
|
|
|
- march is for using the framework to curate an index of the Soupboat
|
|
|
|
- the **last three months** are dedicated to the _external public_
|
|
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- the **last three months** are dedicated to
|
|
|
|
|
|
|
|
- _external public_
|
|
|
|
- here i see myself as curator and designer
|
|
|
|
- here i see myself as curator and designer
|
|
|
|
|
|
|
|
- to make our doc accessible from the outside
|
|
|
|
- our group will be busy with the projects
|
|
|
|
- our group will be busy with the projects
|
|
|
|
- lot of the contents for the documentation produced here
|
|
|
|
- writing contents for the documentation
|
|
|
|
- how to make them accessible from the outside
|
|
|
|
- with the aid of the doc framework
|
|
|
|
- which format?
|
|
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- and then?
|
|
|
|
|
|
|
|
- after xpub?
|
|
|
|
|
|
|
|
- well i can see myself joining a new community!
|
|
|
|
|
|
|
|
- would it be another study program, a coop, a studio
|
|
|
|
|
|
|
|
- bringing the methods developed with this framework
|
|
|
|
|
|
|
|
- and adjust
|
|
|
|
|
|
|
|
- according to the new situation
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **references**
|
|
|
|
|
|
|
|
- Situated Software, Clay Shirky
|
|
|
|
|
|
|
|
- Situated Knowledges, Donna Harawai
|
|
|
|
|
|
|
|
- List and complexity: Annemarie Mol & John Law
|
|
|
|
|
|
|
|
- Diataxis Documentation Framework, Daniele Procida
|
|
|
|
|
|
|
|
- Software Studies Revisited, W H K Chun, W Soon, N Wardrip-Fruin, J Zhu
|
|
|
|
|
|
|
|
|
|
|
|
<!--
|
|
|
|
<!--
|
|
|
|
|
|
|
|
|
