Compile a list of resources to explore the _documentation of coding related practices_ from a community-based perspective, as a process of sharing knowledge and making worlds together around _situated software_.
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.
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_ (computationalculture.net, 2022): the one of software and the one of situatedness. This complexity will hopefully be preserved and encoded in the relations between different items.
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.
Imagine a [tools list](https://github.com/everestpipkin/tools-list) gradually branching as a coral reef, with the items _interfering with each other_ (Haraway, 1988), resembling the heterogeneous Celestial Emporium reported by Borges (Borges, 1968). 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.
Imagine a [tools list](https://github.com/everestpipkin/tools-list) gradually branching as a coral reef, with the items _interfering with each other_ (Haraway, 1988), resembling the heterogeneous _Celestial Emporium_ reported by Borges (Borges, 1968). 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.
_Software documentation_ is not just a technical list of 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.
@ -137,6 +137,7 @@ To make place for code turns to be a necessary act of care in the process of sha
## References
- Chun W., Soon W., Wardrip-Fruin N., Zhu J. (2022). Software Studies, Revisited | Computational Culture. [online] Available at: http://computationalculture.net/software-studies-revisited/ [Accessed 9 Oct. 2022].
- Fuller, M. ed. (2008). Software Studies: A Lexicon. Massachusetts: The MIT Press.
- Haraway, D. (1988). Situated Knowledges: the Science Question in Feminism and the Privilege of Partial Perspective. Feminist Studies, 14(3), pp.575–599. doi:10.2307/3178066.
- Jorge Luis Borges (1968). Other inquisitions. New York Simon And Schuster Imp.
@ -148,6 +149,7 @@ To make place for code turns to be a necessary act of care in the process of sha
- Shirky, C. (2004). Shirky: Situated Software. [online] Available at: https://www.gwern.net/docs/technology/2004-03-30-shirky-situatedsoftware.html [Accessed 11 Oct. 2022].
- Ullman, E. (2013). Close to the machine: Technophilia and its Discontents. London: Pushkin Press