pp3

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
+
+<br>
+
+-   _our group_
+-   up to 20 participants
+-   10~ students + tutors + guests
+-   coming from various backgrounds
+-   rich and diverse approach to coding
+-   small community!
+
+<br>
+
+-   _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/)
+
+<br>
+
+-   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
+
+<br>
+
+-   _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
+
+<br>
+
+-   _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
+
+<br>
+
+-   **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+
+
+<br>
+
+-   Documentation is a space that interfaces between the code, the user, the developer, and the world.