4x faster readme

master
km0 2 years ago
parent 6339341a00
commit be3c3ff9f9

@ -0,0 +1,19 @@
[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.
```
# labsong - songs for difficult grad labor
location ^~ /labsong/ {
proxy_pass http://localhost:3157/soupboat/labsong/;
include proxy_params;
}
# ATTENTION: use port 3158 for the next project!!!! ;))
```
_NGINX configuration with gentle, incremental reminder on which port to use for the next app_
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