diff --git a/img/chae_api.jpg b/img/chae_api.jpg new file mode 100644 index 0000000..5425da4 Binary files /dev/null and b/img/chae_api.jpg differ diff --git a/img/sheep_rider.jpg b/img/sheep_rider.jpg new file mode 100644 index 0000000..c9c85ac Binary files /dev/null and b/img/sheep_rider.jpg differ diff --git a/img/supi_flask.jpg b/img/supi_flask.jpg new file mode 100644 index 0000000..97c1820 Binary files /dev/null and b/img/supi_flask.jpg differ diff --git a/img/trolley.jpg b/img/trolley.jpg new file mode 100644 index 0000000..72f1e8c Binary files /dev/null and b/img/trolley.jpg differ diff --git a/static/style.css b/static/style.css index bafefc9..04490cd 100644 --- a/static/style.css +++ b/static/style.css @@ -10,7 +10,18 @@ body * { display: inline; } +a { + color: currentColor; +} + img { + max-height: 75vh; + margin: 64px auto; + display: block; +} + +ul img { + display: inline-block; height: 1.6rem; vertical-align: middle; width: auto; @@ -21,10 +32,19 @@ li:first-child img { vertical-align: bottom; } +ul img:hover { + scale: 300%; +} + ul { display: block; padding: 0; margin: 0; + /* opacity: 0.4; */ +} + +ul:hover { + opacity: 1; } ul + ul { @@ -64,6 +84,11 @@ em { line-height: 1rem; } +em a { + text-decoration: none; + color: dodgerblue; +} + code { background-color: #eee; } diff --git a/txt/assessment.md b/txt/assessment.md index dd1fda9..ff6c15b 100644 --- a/txt/assessment.md +++ b/txt/assessment.md @@ -37,14 +37,14 @@ - _Annotation Compass_ - _Birthday card collector_ - _Xquisite branch_ -- _workbook_ + - _textoscope_ - _workinon_ - _skimmer_ - _wlist_ - _tlist_ - _bcard_ -- _Padliography2_ + - _kiwiboat_ - _overture atlas_ - _chaos puzzles_ diff --git a/txt/eggs.md b/txt/eggs.md deleted file mode 100644 index 16471d6..0000000 --- a/txt/eggs.md +++ /dev/null @@ -1,5 +0,0 @@ -- _🥚_ -- cook the pasta -- put the eggs -- runny or not? -- enjoy \ No newline at end of file diff --git a/txt/pp3.md b/txt/pp3.md new file mode 100644 index 0000000..010d172 --- /dev/null +++ b/txt/pp3.md @@ -0,0 +1,321 @@ +![trolley de la muerte](img/trolley.jpg) + +- _kamo_ _he/hum_ _IT_ +- background +- development of custom software +- to facilitate +- agency-on +- comprehension-of +- complex systems +- before XPUB +- tools were never the main focus +- just instruments to be activated +- within particular contexts +- tailored to specific moments +- then forgotten + +
+ +- During first year at XPUB something changed +- Working together with my classmates +- let me realize the importance of +- sharing tools +- develop not just for myself +- but also for others +- together with others +- **code as common** +- importance to create a space +- for these tools to circulate +- importance to build narrations +- around these instruments + +
+ +- Prototyping writing machines +- to keep track of what's happening around us +- _CMS_ +- [wiki based](/soupboat/padliography/) +- [git based](/soupboat/~kamo/) +- [jupiter notebook based](/soupboat/si16/) +- _Cookbooks_ +- [soups](/soupboat/soup-gen/) +- [reading methods](https://issue.xpub.nl/18/06/) +- _Notation systems_ +- [to annotate images](/soupboat/si16/annotation-compass/annotate/Naamloos 1.png/) +- [to annotate synth](https://hub.xpub.nl/soupboat/workbook/instruments/test_instrument/add) +- _Web-to-print_ +- [click to print 80 000 post-it](/soupboat/postit) +- [libretto for emergent opera](https://issue.xpub.nl/18/03/) +- [this and other lists](..) +- collecting things +- connecting things + +
+ +- Every machine implies a different way to think +- requires to balance between different priorities +- accessibility +- susteinability +- flexibility + +![goat and cheese](img/sheep_rider.jpg) + +- Software development +- as a form of publishing +- as a form of care +- how to +- weave together multiple voices +- open to diverse knowledges +- share pov around software +- _??????_ + +
+ +- Started thinking about **documentation** +- interface between +- code +- user +- developer +- world +- **not just as technical writing** +- **but also worldbuilding** +- to orientate code in the world +- everything is a file +- everything is a frog + +![pad as frogs](https://git.xpub.nl/kamo/pad-bis/media/branch/master/lifecycle.jpg) + +- Hackpacts +- README.md +- Documentation for the Padliography (with frogs) +- Documentation for the Workbook (with Supi) +- funny cover images _[1](https://git.xpub.nl/kamo/souptxt)_ _[2](https://git.xpub.nl/kamo/pad-bis)_ _[3](https://git.xpub.nl/kamo/kiwiboat)_ +- writing docs together (with Chae) _[4](https://git.xpub.nl/manetta/flask-example/src/branch/documentation)_ +- now i get triggered whenever doc is mentioned +- realized that writing doc is HARD +- and a couple of other things + +
+ +- _contradiction_ +- frustration while dealing with undocumented software +- and at the same time never documenting anything +- [xquisite branch on git](https://git.xpub.nl/kamo/exquisite-branch) + +
+ +- _participation_ +- lack of documentation +- is a barrier +- for the participation of diverse knowledges +- in the the making of software +- At the same time +- this very lack +- could be a starting point +- A space to reclaim given margins and entry points +- A chance to overwrite what is normalized +- Let more voices participate +- in the discourse that is software +- _example_ +- [RTFM, Mara Karaya‌nni](https://psaroskalazines.gr/pdf/rtfm_zine_screen.pdf) + +![chae api drawing](img/chae_api.jpg) + +- Chae drawings to explain API + +![supi flask design](img/supi_flask.jpg) + +- Supi design to diygest Flask + +
+ +- _worlding_ +- a way to produce narrations around software +- create a world for the code to inhabit +- to give affordances +- stretch what is possible +- to do or to think with it +- [The Screenless Office, Brendan Howel](http://screenl.es/) + +
+ +- **recap** +- community tinkering with code +- lot of experiments +- scattered all around +- not very public +- a generous group +- willing to share +- knowledge & software +- documentation seems an ideal surface +- to host ideas in close contact with code +- letting them entangle and shape each other + +
+ +- elevator pitch starts after 12 min of intro +- **what do you want to make?** +- a small documentation framework +- focused on the development of situated software +- in the context of our group in XPUB + +
+ +- situated software +- requires +- situated documentation + +
+ +- So is this just a documentation of the Soupboat? +- yes +- no +- it's two things +- it starts as documentation around the Soupboat +- to develop a documentation framework for situated software +- chicken-egg meme + +
+ +- _docs_ +- **a soft index of our software** +- what do they do +- where to find them +- how to use them +- from where they come from +- and where are they going +- how we are documenting them +- how to contribute +- why are they important for us + +
+ +- this docs is for two kinds audience +- _internal public_ +- that would be us +- offer a way to keep track +- and orientate knowledge +- share a common interface +- _external public_ +- a way to navigate the Soupboat +- a rich ecosystem + +
+ +- _framework_ +- **a system of software & practices** +- shared surface or interface +- one sentence games ritual +- the breakfast club +- flexible and expressive enough +- to be useful for us +- and accessible for others +- a list of resources +- tools +- references +- strategies +- entry points +- to articulate code as common +- and documentation as a form of care + +
+ +- and this is maybe the moment for a small demo??? +- flat markup bonfire +- show don't tell + +
+ +- **the plan** +- adjust the plan from the project proposal +- **first 3 months** passed experimenting with documentation +- the **next 3 months** are focused on the _internal public_ +- here i see myself as facilitator +- introducing the framework +- january is for prototyping small frameworks +- february is for offering them to the group +- march is for using the framework to index the Soupboat +- the **last three months** are dedicated to the _external public_ +- here i see myself as curator and designer +- our group will be busy with the projects +- lot of the contents for the documentation produced here +- how to make them accessible from the outside +- which format? + + diff --git a/txt/test.md b/txt/test.md deleted file mode 100644 index 3e0dc58..0000000 --- a/txt/test.md +++ /dev/null @@ -1,4 +0,0 @@ -- ![a crab](img/crab.jpg) -- ahhhhh -- a new file -- hello hello