From c53f64de6b8dde1162b67b7936f0a180bcb5aa7b Mon Sep 17 00:00:00 2001 From: km0 Date: Fri, 16 Jun 2023 17:59:15 +0200 Subject: [PATCH] recap --- contents/final.md | 29 +++++++++++++++++------------ templates/final.html | 29 +++++++++++++++++++++++++---- update.sh | 3 ++- 3 files changed, 44 insertions(+), 17 deletions(-) diff --git a/contents/final.md b/contents/final.md index 21c040f..8906daf 100644 --- a/contents/final.md +++ b/contents/final.md @@ -1,35 +1,40 @@ -In this presentation i will look at the work made across the 2 years to reflect on how it changed my understanding of code documentation. +# Ok time to wrap it up -Code documentation intended as a rich set of practices: comments in code, readme files, tutorials, guides, references etc., but also moments of collective learning, workshops, pair programming and collaborative documenting +In this presentation i will look at the work made across the 2 years to reflect on how it changed my understanding of programming and code documentation. -These aspects are usually marginal in software development: byproducts surroinding the real thing, extra and treats not always available in the scarce economies around documentation. +Code documentation here is intended as a rich set of practices: comments in code, readme files, tutorials, guides, references etc., but also moments of collective learning, workshops, pair programming and collaborative writing. + +These aspects are usually marginal in software development: byproducts surroinding the real thing, extra work, and resources often not available in the scarce economy around documentation. I would like to focus on these marginal zones, bring them to the center and explore how do they influence practices of programming & sociality around software development. -The required awesome list of things done during these two years is left in the background. +The institutional required list of things done during these two years is left in the background, squeeze your eyes and move the cursor to the edges to have a better focus. - -## your thesis (only a brief overview for context, as this has been assessed separately in depth), +## Brief thesis overview for context -Excerpts from [Hello Worlding: code documentation as entry point / backdoor to programming practices](https://hub.xpub.nl/soupboat/~kamo/thesis/) +Excerpts from [Hello Worlding](https://hub.xpub.nl/soupboat/~kamo/thesis/) > Code documentation is an ideal publishing surface to create worlds around software, and to orientate software in the world. -> The nature of code documentation is to create entry points for people to participate in programming practices. To encode and filter knowledge, and ultimately to share it with others. This "nature", however, does not come without issues. It makes a lot of assumptions about who's reading, expecting experts, or engineers, or dudes. Its language is unwelcoming: too dense, too technical, very gendered and unable to address anyone but the neurotypical-white-cis-male programmer. Documentation requires an enormous amount of care, energy and time to be maintained, and it's done always out of budget, always as a side project, always at the end, and only if there's time left. +
+ +> The nature of code documentation is __to create entry points for people to participate in programming practices__. To encode and filter knowledge, and ultimately to share it with others. This "nature", however, does not come without issues. __It makes a lot of assumptions about who's reading__, expecting experts, or engineers, or dudes. Its language is unwelcoming: too dense, too technical, very gendered and unable to address anyone but the neurotypical-white-cis-male programmer. __Documentation requires an enormous amount of care, energy and time to be maintained, and it's done always out of budget, always as a side project, always at the end, and only if there's time left__. + +> Even if it does a questionable job at creating entry points, code documentation still has a lot of __potential as a backdoor__. It's a publishing surface whose reach extends through time and space. Time because it meets programmers at different moments in their lives: **from the _hello world_ till the _how to uninstall_**, and it influences thinking about software continuously, and from different perspectives. Space because it comes in many different possible formats, and can shapeshift to serve different occasions: from simple .txt files to entire websites, from coding workshops to comments in the source code to series of video tutorial. The question then becomes: can we make use of these backdoors to infiltrate programming practices and open more entry points from within? + +
-> Even if it does a questionable job at creating entry points, code documentation still has a lot of potential as a backdoor. It's a publishing surface whose reach extends through time and space. Time because it meets programmers at different moments in their lives: from the _hello world_ till the _how to uninstall_, and it influences thinking about software continuously, and from different perspectives. Space because it comes in many different possible formats, and can shapeshift to serve different occasions: from simple .txt files to entire websites, from coding workshops to comments in the source code to series of video tutorial. The question then becomes: can we make use of these backdoors to infiltrate programming practices and open more entry points from within? +> I started this research for of two reasons. The first is that I love programming because is like learning another language: not just a new bag of words and a different grammar, but a whole new way of thinking, a lens through which to look at the world. Coding means __to express ideas with the reduced vocabulary of a programming language.__ As in poetry, these constraints stimulate creativity, and encourage a diligent yet playful approach. Working with different programming languages and on different systems __transforms thinking in multivarious ways__, and that is extremely exciting. -> I started this research for of two reasons. The first is that I love programming because is like learning another language: not just a new bag of words and a different grammar, but a whole new way of thinking, a lens through which to look at the world. Coding means to express ideas with the reduced vocabulary of a programming language. As in poetry, these constraints stimulate creativity, and encourage a diligent yet playful approach. Working with different programming languages and on different systems transforms thinking in multivarious ways, and that is extremely exciting. +> The second reason is that I want to __share this excitement with others__, especially with my friends. __To be able to think and make sense together of what's happening around us, and come up with alternatives or responses or tools that suit us better.__ Because of the steep learning curve of programming and the other barriers previously mentioned, this has often not been possible. But now we know that there are other ways in, and that it is possible to open up even more. -> The second reason is that I want to share this excitement with others, especially with my friends. To be able to think and make sense together of what's happening around us, and come up with alternatives or responses or tools that suit us better. Because of the steep learning curve of programming and the other barriers previously mentioned, this has often not been possible. But now we know that there are other ways in, and that it is possible to open up even more. ## your individual contributions to the special issues, Ahah what do we even mean by _"individual"_? -Note that every special issue is a wild ecosystem of things happening at the same time: some of them have the brief lifespan of a cactus flower, some of them reach the public, some others remain in the background, some are subtle gestures, some crazy dangerous proposal. Some info for context: diff --git a/templates/final.html b/templates/final.html index 41bd693..60c0f1e 100644 --- a/templates/final.html +++ b/templates/final.html @@ -26,13 +26,13 @@ filter: blur(10px); transform: translate(10px); - transition: all 0.2s ease-out; + transition: all 0.4s ease-in; } .list:hover { filter: blur(1px); transform: translate(0); - transition: all 1s ease-in; + transition: all 0.6s ease-out; } .list ul { @@ -48,7 +48,8 @@ .contents { position: relative; z-index: 50; - margin: 32px auto; + margin: 0 auto; + padding-top: 32px; font-size: 42px; max-width: 60ch; @@ -59,7 +60,7 @@ line-height: 1.6; - transition: all 0.6s ease-out; + transition: all 0.6s ease-out, opacity 2s ease-out 0.4s; } .contents:hover { @@ -74,6 +75,26 @@ color: white; } + blockquote { + font-style: italic; + font-family: serif; + + } + + blockquote:after { + content: '𓆏'; + text-align: center; + display: flex; + justify-content: center; + } + + strong { + background-color: white; + color: black; + font-weight: normal; + padding-inline: 0.5ch; + } + diff --git a/update.sh b/update.sh index 53dae74..9428c66 100644 --- a/update.sh +++ b/update.sh @@ -1,2 +1,3 @@ cd /home/kamo/public_html -git pull \ No newline at end of file +git pull +