working on readmesss

master
km0 12 months ago
parent be3c3ff9f9
commit 0b4b44fa01

@ -1,19 +1,15 @@
[How to make your server run 4 times faster](https://git.xpub.nl/kamo/4x-faster)
From the perspective of hosting others into "our" code, documentation becomes a form of hospitality. A form of care for a shared space. In XPUB, each group begins its two-years programme by setting up a self-hosted server. We called ours Soupboat, and it houses many of our prototypes and experiments. This small server, running on a Raspberri Pi, feels like a place to call home on the internet. Over the past two years we have done all sorts of projects there: generated web-to-print publications, custom CMSs to keep track of birthdays, Etherpad documents, and soup recipes, workshops, personal wikis, and so on. While living on a server with others, my approach to code began slowly to change. Publishing open git repositories, instead of hiding behind private ones. Writing more readme files to be more generous with friends and colleagues and tutors. Cultivating small gestures and rituals, like leaving comments in config files to remind others where to mount the next app or where to find some credentials.
From the perspective of hosting others into "our" code, documentation becomes a form of hospitality. A form of care for a shared space.
```
# labsong - songs for difficult grad labor
In XPUB, each group begins its two-years programme by setting up a self-hosted server. We called ours Soupboat, and it houses many of our prototypes and experiments. This small server, running on a Raspberri Pi, feels like a place to call home on the internet. Over the past two years we have done all sorts of projects there: generated web-to-print publications, custom CMSs to keep track of birthdays, Etherpad documents, and soup recipes, workshops, personal wikis, and so on. While living on a server with others, my approach to code began slowly to change. Publishing open git repositories, instead of hiding behind private ones. Writing more readme files to be more generous with friends and colleagues and tutors. Cultivating small gestures and rituals, like leaving comments in config files to remind others where to mount the next app or where to find some credentials.
location ^~ /labsong/ {
proxy_pass http://localhost:3157/soupboat/labsong/;
include proxy_params;
}
At the same time, this awareness grew by acknowledging the particular context of this [situated software](https://gwern.net/doc/technology/2004-03-30-shirky-situatedsoftware.html). In many readme files for example, the explanations are tailored specifically for the Soupboat, and they cannot probably be ported 1:1 somewhere else.
Nonetheless, the space is prepared for hosting new guests.
_(maybe expand a bit here)_
# ATTENTION: use port 3158 for the next project!!!! ;))
```
_NGINX configuration with gentle, incremental reminder on which port to use for the next app_
[NGINX configuration](https://git.xpub.nl/kamo/pad-bis#nginx-configuration)
[Drw - Going online](https://git.xpub.nl/kamo/drw#going-online)
At he same time, this awareness grew by acknowledging the particular context of this small setup, of this [situated software](https://gwern.net/doc/technology/2004-03-30-shirky-situatedsoftware.html). In many readme for example, such as the one for the networked drawing app [drw](https://git.xpub.nl/kamo/drw) or the padliography, the explanations are tailored specifically for the Soupboat, and they cannot probably be ported 1:1 somewhere else. Nonetheless, the space is prepared for hosting new guests.
![Drw - Going online](https://git.xpub.nl/kamo/drw#going-online)

Loading…
Cancel
Save