From 49fee270e4928c8091e6d45e547b81e89ccde3af Mon Sep 17 00:00:00 2001
From: Francesco Luzzana <luzzanafrancesco@gmail.com>
Date: Tue, 13 Dec 2022 00:17:56 +0100
Subject: [PATCH] pp3

---
 txt/pp2.md | 84 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 84 insertions(+)
 create mode 100644 txt/pp2.md

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
+
+<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.