You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

161 lines
6.2 KiB
Markdown

1 year ago
## first round
- list of documentation related things done so far
- in no particular order
1 year ago
<br>
1 year ago
- [tag experiments](https://hub.xpub.nl/soupboat/tag/)
- [tag git](https://git.xpub.nl/kamo/tag)
- [01 Pathways](https://hub.xpub.nl/soupboat/tag/01/)
- [02 Openings](https://hub.xpub.nl/soupboat/tag/02/)
- [03 Pair](https://hub.xpub.nl/soupboat/tag/03/)
- [04 Tree](https://hub.xpub.nl/soupboat/tag/04/)
- [Writing Machines](https://hub.xpub.nl/soupboat/wm/)
- [exex example](https://hub.xpub.nl/soupboat/wm/entries/exex/)
- [Writing Machines doc page](https://hub.xpub.nl/soupboat/~kamo/projects/writing-machines/)
- [voicing doc - open call radio worm](https://git.xpub.nl/kamo/docr)
- Hello worlding - Code documentation as entry point / backdoor to programming practices (thesis)
- [documentation sessions](https://hub.xpub.nl/soupboat/docs/)
- [documentation sessions @varia](https://varia.zone/en/code-documentation.html)
- [doc ses @soupboat](https://hub.xpub.nl/soupboat/~kamo/projects/dyc/)
- [doc ses @git](https://git.xpub.nl/kamo/dyc)
- [bonfire - flat markup documentation language](https://hub.xpub.nl/soupboat/bonfire/)
- [bonfire git](https://git.xpub.nl/kamo/bonfire)
- [dlist git - prototype for flat markup lang](https://git.xpub.nl/kamo/dlist)
1 year ago
- from here is more documentation for writing machines
- [pad-bis docs](https://git.xpub.nl/kamo/pad-bis)
- [wlist (this page!) docs](https://git.xpub.nl/kamo/wlist)
- made me think that an excercise for today would be: to inflate a documentation, providing context for different choices that were made
- [exex - git](https://git.xpub.nl/kamo/exex)
- [exex - exquisite excerpts](https://hub.xpub.nl/soupboat/exex/)
- [exex - docs](https://hub.xpub.nl/soupboat/exex/display/about/)
- [drw - git](https://git.xpub.nl/kamo/drw)
- [drw - workshop](https://hub.xpub.nl/soupboat/~kamo/projects/ws-js-ws/)
- [textoscope - text intensities with xml](https://git.xpub.nl/kamo/textoscope)
- [textoscope - text intensities with xml](https://git.xpub.nl/kamo/textoscope)
- [workinon - documentation as snapsoht](https://hub.xpub.nl/soupboat/workinon/)
- [workinon - git](https://git.xpub.nl/kamo/workinon)
<br>
## second round
- sort things out a bit
<br>
- _writing machines_
- [bonfire - shared documentation surface](https://hub.xpub.nl/soupboat/bonfire/)
- [1dl - flat markup language](https://git.xpub.nl/kamo/dlist)
- [padliography](https://hub.xpub.nl/soupboat/padliography/)
- [exex - exquisite excerpts](https://hub.xpub.nl/soupboat/exex/)
- [textoscope - text intensities with xml](https://git.xpub.nl/kamo/textoscope)
- [wlist - writing list machine](https://hub.xpub.nl/soupboat/wlist/)
- [Pair Documenting](https://hub.xpub.nl/soupboat/tag/03/)
- [Tree](https://hub.xpub.nl/soupboat/tag/04/)
<br>
- _documentation_
- [thoughts about documentation session](https://hub.xpub.nl/soupboat/~kamo/projects/dyc/)
- [writing list docs](https://git.xpub.nl/kamo/writing-list)
- [padliography wiki](https://pzwiki.wdka.nl/mediadesign/Padliography)
- [exex - docs](https://hub.xpub.nl/soupboat/exex/display/about/)
- [wm/exex example](https://hub.xpub.nl/soupboat/wm/entries/exex/)
<br>
- _archives_
- [soupboat](https://hub.xpub.nl/soupboat/)
- [documentation workout](https://hub.xpub.nl/soupboat/~kamo/)
- [Pathways](https://hub.xpub.nl/soupboat/tag/01/)
- [tag experiments](https://hub.xpub.nl/soupboat/tag/)
- [Writing Machines](https://hub.xpub.nl/soupboat/wm/)
- [Writing Machines doc page](https://hub.xpub.nl/soupboat/~kamo/projects/writing-machines/)
<br>
- _workshops_
- [documentation sessions](https://hub.xpub.nl/soupboat/docs/)
- [documentation sessions @varia](https://varia.zone/en/code-documentation.html)
- [drw - workshop](https://hub.xpub.nl/soupboat/~kamo/projects/ws-js-ws/)
<br>
- _writings_
- [Hello worlding - Code documentation as entry point / backdoor to programming practices](https://hub.xpub.nl/soupboat/~kamo/thesis/) (thesis)
- [Openings](https://hub.xpub.nl/soupboat/tag/02/)
- [voicing doc - open call radio worm](https://git.xpub.nl/kamo/docr)
<br>
- _repo_
- [tag](https://git.xpub.nl/kamo/tag)
- [workinon](https://git.xpub.nl/kamo/workinon)
- [textoscope](https://git.xpub.nl/kamo/textoscope)
- [doc ses](https://git.xpub.nl/kamo/dyc)
- [bonfire](https://git.xpub.nl/kamo/bonfire)
- [dlist - prototype for flat markup lang](https://git.xpub.nl/kamo/dlist)
- [wlist - writing list](https://git.xpub.nl/kamo/writing-list)
- [exex](https://git.xpub.nl/kamo/exex)
- [drw ](https://git.xpub.nl/kamo/drw)
- [pad-bis](https://git.xpub.nl/kamo/pad-bis)
## third round
- emerging patterns
- great interest in developing tools & writing machines
- lot of them
- often with half-baked documentation
- or with documentation that could be further inflated
- with new eyes so to say
<br>
- _idea_
- a toolkit of writing machines
- created in the context of the soupboat
- with curated documentation
- that offers not only reference on how to use the writing machines
- but also provides context around specific choices made during development
- a way to use code documentation to flesh worlds around these tools
<br>
- _sections_
- context: soupboat
- index of writing machines
- documentation for every writing machine
- thoughts around archiving situated software
- thoughts around future of the soupboat
<br>
- output
- _digital_
- website?
- (admittedly im a bit bored of that)
- but it's probably the most viable option
- could it be something different??
- really inspired by soft serve
- publishing through ssh
- [charm.sh](https://charm.sh/)
- _physical_
- could make use of all the things learned with [birds press](https://hub.xpub.nl/soupboat/~kamo/projects/birds-press/), [catalog](https://git.xpub.nl/kamo/birds-press)
- would be nice to have something that fit the shop format
- or even just a small pubblication
<br>
- _grad show_
- i have contrasting feelings about exhibiting something on a computer
- at the same time it's easier to relate with a writing machine and its surroundings hands-on
- but the entry point through which relate for the audience could not be in the writing machine, but in the documentation
- that makes sense
- the whole point of this toolkit is to bring documentation practices in foreground
- the tools are more like joints to sustain this continuous thinking