From a36a637f8882f4527c3ce033c3c793921fcbb19c Mon Sep 17 00:00:00 2001 From: "kam (from the studio)" Date: Fri, 18 Nov 2022 17:37:01 +0100 Subject: [PATCH] gpp --- projects/gpp/gpp.md | 53 ++++++++++++++++++++------------------------- 1 file changed, 24 insertions(+), 29 deletions(-) diff --git a/projects/gpp/gpp.md b/projects/gpp/gpp.md index ed500a2..ef8a6b5 100644 --- a/projects/gpp/gpp.md +++ b/projects/gpp/gpp.md @@ -6,35 +6,30 @@ categories: cover: birdu.jpg cover_alt: someone wants to graduate eh date: 08/10/2022 -description: The secret plan to graduate +description: The secret plan to graduate - graduation project proposal slug: gpp -title: Graduation Project Proposal +title: Situated Docs --- ![Political compass of knowledge + references](compass_2.jpg) ## What do you want to make? -A list of devices to explore _software documentation_, that is the process of sharing knowledge and making worlds around software. +Compile a list of resources to explore the _documentation of coding related practices_ from a community-based perspective, that is the process of sharing knowledge and making worlds together around _situated software_ (Shirky, 2004). -These devices will be of various nature: tools, thoughts, anecdotes, excercises, prompts, secrets, ... They will offer entry points to articulate _software documentation_ as a form of care. +These resources will be of various nature: tools, thoughts, anecdotes, excercises, prompts, strategies, ... They will offer entry points to articulate _software documentation_ as a form of care. -Some elements of the list will relate to the materiality and surfaces where documentation is hosted, +To work within the constraints of a structure such as the list will help to think through the complexity of dealing with a double unknown: the one of software and the one of situatedness. This complexity will hopefully be preserved and encoded in the relations between different items. - +(Imagine a [GitHub list](https://github.com/everestpipkin/tools-list) gradually branching like a coral reef, with the items _interfering_ with each other, in something that resembles more that classic list from Borges than a dry index of references.) -while others will be more entangled with the actors involved in the process. +Some elements of the list will relate to the materiality and surfaces where documentation is hosted, while others will engage more with the actors and frameworks entangled in the process. - - -To work within the constraints of a structure such as the list will help to think through the complexity of the topic. This complexity will hopefully be preserved and encoded in the relations between different items. +--Following to the idea that items in a list aren't necessarily responses to the same questions, yet they hang togheter (Law, Mol 2002) _Software documentation_ is not just a list of technical procedures, but also a matter of providing context and orientate code in the world. In the same way, the list is meant to be a texture where to weave together multiple voices and diverse registry, in order to re-enchant the making of software. - - - -> "A list doesn't have to impose a single mode of ordering on what is included in it. Items in the list aren't necessarily responses to the same questions but may hang together in other ways... a list differs from a classification in that it recognizes its incopleteness. It doesn't even need to seek completeness. If someone comes along with something to add to the list, something that emerges as important, this may indeed be added to it." _[John Law and Annemarie Mol, Complexities: Social Studies of Knowledge Practices]_ +> "A list doesn't have to impose a single mode of ordering on what is included in it. Items in the list aren't necessarily responses to the same questions but may hang together in other ways... a list differs from a classification in that it recognizes its incopleteness. It doesn't even need to seek completeness. If someone comes along with something to add to the list, something that emerges as important, this may indeed be added to it." \_[John Law and Annemarie Mol, Complexities: Social Studies of Knowledge Practices] ## Why do you want to make it? @@ -143,10 +138,8 @@ To make place for code turns to be a necessary act of care in the process of sha ## References/bibliography -Start from here - -- Fuller, M ed. (2008) Software Studies: A Lexicon, MIT Press -- Ullman, E (2013) Close to the machine: Technophilia and its Discontents, Pushkin Press +- Fuller, M. ed. 2008. Software Studies: A Lexicon. Cambridge, Massachusetts: The MIT Press. +- Ullman, E. (2013) Close to the machine: Technophilia and its Discontents. London, England: Pushkin Press - Law, J ed. and Mol, A ed. (2002) Complexities: Social Studies of Knowledge Practices, Duke University Press Books @@ -157,24 +150,26 @@ And then a list of possible references -- Sterling, B (2005) Shaping Things, MIT Press - - - - - + + + + + - -- Knuth, D E (1992) Literate Programming, Center for the Study of Language and Information + - Brodie, L (1984) Thinking Forth, Punchy Publising -- Wendy Hui Kyong Chun, "On Software, or the Persistence of Visual Knowledge" (2005) Grey Room. 18 + -- Lethbridge, Chantelle & Sim, Susan & Singer, Janice. (1999). Software Anthropology: Performing Field Studies in Software Companies. -- Crowston, Kevin and Howison, James, "The Social Structure of Open Source Software Development Teams" (2003). School of Information Studies - Faculty Scholarship. 123. + + - Shirky, C (2004) [Situated Software](https://www.gwern.net/docs/technology/2004-03-30-shirky-situatedsoftware.html) - Catgirl (2022) [Comfy Software](https://catgirl.ai/log/comfy-software/) - Li, J (2020) [Where Did Software Go Wrong?](https://blog.jse.li/posts/software/) - [wiki.c2.com](https://wiki.c2.com/) + +https://github.com/everestpipkin/tools-list +https://github.com/hng/tech-coops +https://github.com/sindresorhus/awesome