|
|
|
@ -100,7 +100,7 @@
|
|
|
|
|
- _contradiction_
|
|
|
|
|
- frustration while dealing with undocumented software
|
|
|
|
|
- and at the same time never documenting anything
|
|
|
|
|
- haters gonna look at the [xquisite branch on git](https://git.xpub.nl/kamo/exquisite-branch)
|
|
|
|
|
- [xquisite branch on git](https://git.xpub.nl/kamo/exquisite-branch)
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
@ -116,8 +116,9 @@
|
|
|
|
|
- A chance to overwrite what is normalized
|
|
|
|
|
- Let more voices participate
|
|
|
|
|
- in the discourse that is software
|
|
|
|
|
- _example_
|
|
|
|
|
- _examples_
|
|
|
|
|
- [RTFM, Mara Karayanni](https://psaroskalazines.gr/pdf/rtfm_zine_screen.pdf)
|
|
|
|
|
- [post-meritocracy manifesto](https://postmeritocracy.org/)
|
|
|
|
|
|
|
|
|
|
![chae api drawing](img/chae_api.jpg)
|
|
|
|
|
|
|
|
|
@ -249,6 +250,23 @@
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
- we already did something similar!
|
|
|
|
|
- SI16 API
|
|
|
|
|
- _url_ [hub.xpub.nl/soupboat/si16/](https://hub.xpub.nl/soupboat/si16/)
|
|
|
|
|
- A set of functions to mess around with vernacular language processing
|
|
|
|
|
- A collective work where everyone contributed with some functions
|
|
|
|
|
- Written in Python through Jupiter Notebook
|
|
|
|
|
- And documented in the very same notebooks
|
|
|
|
|
- With description, examples and references about input and output
|
|
|
|
|
- And then aggregated together as endpoints for the API
|
|
|
|
|
- _example_ [Shout function](https://hub.xpub.nl/soupboat/si16/functions/shout/)
|
|
|
|
|
- A choral API
|
|
|
|
|
- with multiplayer approach to documentation
|
|
|
|
|
- More docs for the backend is available
|
|
|
|
|
- _url_ [hub.xpub.nl/soupboat/~kamo/projects/si16-backend/](https://hub.xpub.nl/soupboat/~kamo/projects/si16-backend/)
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
- **the plan**
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
@ -289,6 +307,7 @@
|
|
|
|
|
|
|
|
|
|
- **references**
|
|
|
|
|
- Situated Software, Clay Shirky
|
|
|
|
|
- Post-meritocracy Manifesto, Coraline Ada Ehmke
|
|
|
|
|
- Situated Knowledges, Donna Harawai
|
|
|
|
|
- List and complexity: Annemarie Mol & John Law
|
|
|
|
|
- Diataxis Documentation Framework, Daniele Procida
|
|
|
|
|