diff --git a/txt/framework.md b/txt/framework.md index 6326d4f..5a39826 100644 --- a/txt/framework.md +++ b/txt/framework.md @@ -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)
@@ -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 Karaya‌nni](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 @@
+- 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/) + +
+ - **the plan**
@@ -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