From 252e39999aa2d47ff482274d484efb7adcef1aaf Mon Sep 17 00:00:00 2001 From: "kam (from the studio)" Date: Tue, 11 Oct 2022 21:37:46 +0200 Subject: [PATCH] documentation! --- projects/gpp/documentation.md | 17 +++++++++++++++-- projects/grs/documentation.md | 1 + 2 files changed, 16 insertions(+), 2 deletions(-) diff --git a/projects/gpp/documentation.md b/projects/gpp/documentation.md index e6d8c64..bcd25f7 100644 --- a/projects/gpp/documentation.md +++ b/projects/gpp/documentation.md @@ -13,9 +13,20 @@ title: Graduation Project Proposal ## Draft Project Proposal +Research on software documentation as an interface between code, users, developers, communities, and the world. +Explore documentation from the perspective of software as a form of care. + +Documenting software it's a difficult and delicate practice. +Writing documentation it's more difficult than writing software itself. +It requires a lot of time and energy, and it involves many different skills: writing, coding, knowing how to share and at which intensity. + +As some piece of code would write: I am documented, therefore I am. + +Undocumented software is invisible, but for the eyes of their own developers. And eventually, it begins to fade as soon as the developer looks away. + ### What do you want to make? -Writing software as a form of care instead of a form of control. +Writing software as a form of care. What kind of resources, experiences and approaches constitute this practice? @@ -157,9 +168,11 @@ The practical aspect depends on the second and third case studies. There are som Tut with Joseph -galloway +galloway protocol situated software, https://www.gwern.net/docs/technology/2004-03-30-shirky-situatedsoftware.html post-meritocratic manifesto josep weizenbaum +Tut with Manetta + --- diff --git a/projects/grs/documentation.md b/projects/grs/documentation.md index c0e8561..6362375 100644 --- a/projects/grs/documentation.md +++ b/projects/grs/documentation.md @@ -178,3 +178,4 @@ _some notes for the project:_ - Padliography category page on the wiki, with the same contents of the README.md and a list of the archives page. - Now when the padliography initialize a new archive, it adds the `[[category: padliography]]` tag, in order to list all the active archives in the category page. +- Next step is: how to make it public?