diff --git a/txt/pp3.md b/txt/framework.md similarity index 79% rename from txt/pp3.md rename to txt/framework.md index 09b24e8..5aa4ef4 100644 --- a/txt/pp3.md +++ b/txt/framework.md @@ -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 @@
- _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 + +
+ - **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 + +
+ +- 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
- and this is maybe the moment for a small demo??? -- flat markup bonfire -- show don't tell +- [flat markup bonfire](/soupboat/bonfire/)
- **the plan** + +
+ - **first 3 months** passed experimenting with documentation -- the **next 3 months** are focused on the _internal public_ + +
+ +- 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 + +
+ +- 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 + +
+ +- 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 + +
+ +- **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