-   Software documentation is a form of care
-   that means
-   _1_
-   **collect contents**

<br>

-   Code and documentation can live together
-   like in the [soup gen](https://hub.xpub.nl/soupboat/soup-gen/)
-   ![soup gen info](img/soup-gen.png)
-   Documentation and doubts can share the same space
-   ![soup gen doubt](soup-gen-q.png)

<br>

-   **situated software**
-   the context is
-   our group in xpub
-   up to 20 participants (10 of us + tutors + guests)
-   various background
-   the main space where these software run is the Soupboat
-   a server running on a rpi
-   that hosts tools and prototypes
-   a list of software
-   here is an index
-   and a general overview

<br>

-   _SI16 API_
    -   Learning how to walk while catwalking
    -   _url_ [hub.xpub.nl/soupboat/si16/](https://hub.xpub.nl/soupboat/si16/)
    -   A set of functions to mess around with vernacular language processing
    -   Published as an API
    -   Sparse architecture
    -   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 documentation for the backend is available
    -   _url_ [hub.xpub.nl/soupboat/~kamo/projects/si16-backend/](https://hub.xpub.nl/soupboat/~kamo/projects/si16-backend/)
-   _SI17 post-it generator_
    -   Generate pubblications in a post-it format
    -   get the contents from a shared repo on git
    -   _url_ [git.xpub.nl/kamo/post-it-contents](https://git.xpub.nl/kamo/post-it-contents)
-   _Soup Generator_
-   _k-pub_
-   _Annotation Compass_
-   _Birthday card collector_
-   _Xquisite branch_
-   _workbook_
-   _textoscope_
-   _workinon_
-   _skimmer_
-   _wlist_
-   _tlist_
-   _bcard_
-   _Padliography2_
-   _kiwiboat_
-   _overture atlas_
-   _chaos puzzles_
-   _soupboat cms_
-   _flaskboat cms_
-   _spawn sticker_
-   _the parliament_
-   _diffractive cookbook_

<br>

-   **brainstorm**
-   list of software
-   with overview
-   where to find the documentation
-   how to contribute writing
-   other references for the proj
-   _tag_
-   software
-   what
-   where
-   doc
-   links
-   dev

<br>

-   _example_
-   (workbook)
-   [what]
-   A tool to keep track and annotate configurations for different instruments
-   to facilitate learning process
-   [where]
-   https://hub.xpub.nl/soupboat/workbook/
-   [doc]
-   https://hub.xpub.nl/soupboat/workbook/documentation
-   https://pad.xpub.nl/p/modcms_documentation
-   draft in progress
-   [dev]
-   main repo
-   https://git.xpub.nl/supisara/workbook
-   svg to interactive panel
-   https://git.xpub.nl/kamo/panel
-   cables system
-   https://git.xpub.nl/kamo/spaghetti
-   [links]
-   brainstorming pad
-   https://pad.xpub.nl/p/modcms
-   [refs]
-   reference for spaghetti cables system
-   https://hub.xpub.nl/soupboat/~kamo/projects/spaghetti/
-   reference for interactive panel generator
-   https://hub.xpub.nl/soupboat/~kamo/projects/panel/
-   (padliography2)

<br>

-   a mix between a TOML config file and a list
-   seems mainly a series of links
-   that is ok
-   navigation is done through [tag]s
-   that could be used to parse the list
-   so in the end is a text-based 1D CMS
-   soft framework
-   with minimal hierarchy
-   (round brackets for the software)
-   aka title of the section
-   [square brackets for the tags]