diff --git a/txt/pp2.md b/txt/pp2.md new file mode 100644 index 0000000..d0848d0 --- /dev/null +++ b/txt/pp2.md @@ -0,0 +1,84 @@ +- **what do you want to make?** +- a small documentation framework +- focused on the development of situated software +- in the context of our group in XPUB + +
+ +- _our group_ +- up to 20 participants +- 10~ students + tutors + guests +- coming from various backgrounds +- rich and diverse approach to coding +- small community! + +
+ +- _our ecosystem_ +- the main space where these software run is the Soupboat +- a self-hosted server running on a Raspberry Pi +- homing tools and prototypes +- _url_ [hub.xpub.nl/soupboat](https://hub.xpub.nl/soupboat/) +- the main space used to document things is the wiki +- along with scattered etherpad documents +- and sometimes git +- _url_ [pzwiki.wdka.nl](https://pzwiki.wdka.nl/mediadesign/) +- _url_ [pad.xpub.nl](https://pad.xpub.nl/) +- _url_ [git.xpub.nl](https://git.xpub.nl/) + +
+ +- So is this just a documentation of the Soupboat? +- yes +- no +- it's two things +- it starts as documentation around the Soupboat +- to develop a documentation framework for situated software +- like the chicken-egg meme + +
+ +- _docs_ +- a soft index of our software +- what do they do +- where to find them +- how to use them +- from where they come from +- and where they are going +- how we are documenting them +- how to contribute +- why are they important for us + +
+ +- _framework_ +- develop ways to document +- our system of software & practices +- flexible and expressive enough +- to be useful for us +- and accessible for others +- a list of resources +- a way to articulate code as common +- and documentation as a form of care + +
+ +- **why?** + +- _1_ +- more documentation +- more participation +- _2_ +- documentation as interface between +- code +- user +- developer +- world +- _3_ +- contradiction betwen +- being frustrated in having to deal with undocumented piece of software +- and a the same time never documenting anything+ + +
+ +- Documentation is a space that interfaces between the code, the user, the developer, and the world.