- 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
- the main space used to document things is the wiki
- along with scattered etherpad documents
- and sometimes git
- url pzwiki.wdka.nl
- url pad.xpub.nl
- url 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.