framework

master
km0 2 years ago
parent 20a0fb41b4
commit c61319e9a4

@ -194,7 +194,7 @@
- _internal public_
- that would be us
- offer a way to keep track
- and orientate knowledge
- orientate knowledge
- share a common interface
- _external public_
- a way to navigate the Soupboat
@ -203,43 +203,96 @@
<br>
- _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**
- 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
- the breakfast club
- flexible and expressive enough
- to be useful for us
- 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>
- and this is maybe the moment for a small demo???
- flat markup bonfire
- show don't tell
- [flat markup bonfire](/soupboat/bonfire/)
<br>
- **the plan**
<br>
- **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
- introducing the framework
- january is for prototyping small frameworks
- february is for offering them to the group
- march is for using the framework to index the Soupboat
- the **last three months** are dedicated to the _external public_
- january is for offering them to the group
- februray is for prototyping software & practice
- march is for using the framework to curate an index of the Soupboat
<br>
- the **last three months** are dedicated to
- _external public_
- here i see myself as curator and designer
- to make our doc accessible from the outside
- our group will be busy with the projects
- lot of the contents for the documentation produced here
- how to make them accessible from the outside
- which format?
- writing contents for the documentation
- with the aid of the doc framework
<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
<!--
Loading…
Cancel
Save