diff --git a/font/Unilegant.woff b/font/Unilegant.woff new file mode 100644 index 0000000..537baea Binary files /dev/null and b/font/Unilegant.woff differ diff --git a/font/Unilegant.woff2 b/font/Unilegant.woff2 new file mode 100644 index 0000000..984d74e Binary files /dev/null and b/font/Unilegant.woff2 differ diff --git a/font/style.css b/font/style.css new file mode 100644 index 0000000..a397db0 --- /dev/null +++ b/font/style.css @@ -0,0 +1,9 @@ +@font-face { + font-family: 'Unilegant'; + src: url('Unilegant.woff2') format('woff2'), + url('Unilegant.woff') format('woff'); + font-weight: normal; + font-style: normal; + font-display: swap; +} + diff --git a/img/discord_rant.png b/img/discord_rant.png new file mode 100644 index 0000000..0040cdd Binary files /dev/null and b/img/discord_rant.png differ diff --git a/img/goat.png b/img/goat.png new file mode 100644 index 0000000..694f90c Binary files /dev/null and b/img/goat.png differ diff --git a/img/trolley.png b/img/trolley.png new file mode 100644 index 0000000..f67be21 Binary files /dev/null and b/img/trolley.png differ diff --git a/index.html b/index.html new file mode 100644 index 0000000..0c3f84b --- /dev/null +++ b/index.html @@ -0,0 +1,132 @@ + + + + + + + Documentation Sessions + + + + +
+

2 hours of head space to write some code documentation

+ +
+
First session
+
+ March 15th
+ 16:00—18:00 +
+
+ around XPUB Studio
+ 4th floor Wijnhaven +
+
+ +
+
Second Session
+
+ March 23rd
+ 19:00—21:00 +
+
+ Varia
+ Gouwstraat 3, Rotterdam +
+
+ +

+ For your new coding project, for the cryptic library you downloaded recently, for a + script that you want to share with others! +

+

+ Too many pieces of code are left alone out there: without an entry point, forgotten, + while outside is raining. Wouldn't it be nice to take care of them? +

+

+ Enter the documentation sessions. Two hours where to sit with source code and write + something about it. From simple instructions to in-depth explanations, or maybe some + drawings to illustrate the overall process. You name it. +

+

+ Writing documentation can be tricky! But let's face this together: prompts and + suggestions will be offered for inspiration, and coffee and snacks for restoration. + If you want there will be space to share your work and exchange feedback, if not no + prob: just enjoy the cozy music and write some docs. +

+ +
+ would you rather develop tools for yourself or for other; but is the trolley problem +
As the famous trolley problem goes: sharing is caring.
+
+ +
+ Padliography - A bookmarking tool for pad (and link in general) +
+ +
+ DRW - A multi surface multi player real time drawing app +
+ +
+ Kiwiboat - How to connect and play around with the media wiki api +
+
+ the famous riddle of goat wolf and cabbage, but now is with coding +
Code documentation = the boat in this puzzle
+
+ +

+ These sessions are part of a research focused on code documentation intended not + just a technical list of procedures, but also a way to provide context and orientate + code in the world. A texture where to weave together multiple voices and diverse + registry, in order to re-enchant the making of software. +

+ +

+ Documentation as a way to produce narrations around software. To create a world for + the code to inhabit, to stretch what is possible to do or to think with it. +

+

+ Documentation as a space for the political in the software. A surface that could + host ideas in close contact with code, letting them entangle and shape each other. +

+ +

+ Read more: + Situated Documentation - a small brainstorming in the format of a list + +

+ +
+ person complaining in discord about software and documentation +
+ +

+ This project grows out of the contradiction of being frustrated in having to deal + with undocumented pieces of code, and at the same time never documenting anything. +

+

+ Developed in the context of the Experimental Publishing master. A really nice place + to be. +

+
+ + diff --git a/style.css b/style.css new file mode 100644 index 0000000..6010267 --- /dev/null +++ b/style.css @@ -0,0 +1,103 @@ +* { + box-sizing: border-box; +} + +html, +body { + margin: 0; + font-family: sans-serif; + font-size: 32px; + line-height: 1.6; +} + +main { + display: grid; + grid-template-columns: repeat(auto-fill, minmax(500px, 1fr)); +} + +main > * { + padding: 16px; + margin: 0; + + min-height: 33vw; + + background-color: rgba(255, 200, 255, 0.3); +} + +main > *:nth-child(even) { + background: none; +} + +h1 { + line-height: 1.3; +} + +figure { + padding: 0; +} + +figcaption { + margin: 8px; +} + +a { + color: currentColor; + display: inline-block; +} + +a:after { + display: inline-block; + content: "↗"; + text-decoration: none; +} + +a:hover { + translate: 10px 0; +} + +a:hover:after { + translate: 5px -5px; +} + +em { + font-family: "Unilegant"; + font-style: normal; + font-size: 1.25em; + text-shadow: 1px 0 0 currentColor, 1px 0 0 currentColor; +} + +img { + width: 100%; + height: auto; + object-fit: contain; +} + +.example:before { + content: "Example:"; + + text-shadow: 1px 0 0 currentColor, 1px 0 0 currentColor; + font-family: "Unilegant"; + font-size: 1.25rem; +} + +.session .number { + opacity: 0.5; +} + +.where:before, +.when:before { + content: "When"; + display: block; + + text-shadow: 1px 0 0 currentColor, 1px 0 0 currentColor; + font-family: "Unilegant"; + font-size: 1.25rem; +} + +.where { + margin-top: 1em; +} + +.where:before { + content: "Where"; +}