From 73432433c3e27aa8009a33de22a16850a0657ec5 Mon Sep 17 00:00:00 2001 From: "kam (from the studio)" Date: Tue, 1 Nov 2022 17:01:42 +0100 Subject: [PATCH] an ecology of software documentaion --- projects/gpp/documentation.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/projects/gpp/documentation.md b/projects/gpp/documentation.md index c890957..72fe973 100644 --- a/projects/gpp/documentation.md +++ b/projects/gpp/documentation.md @@ -17,7 +17,7 @@ _note: I'm using the words toolkit, handbook, map, collection of tools, practice ### What do you want to make? -- An extensible toolkit to explore _software documentation_ as publishing surface in 3d: its materiality, the actors involved and the economy surrounding it. +- An extensible toolkit to explore an ecology of _software documentation_: its materiality, the actors involved and the economy surrounding it. - A handbook with a strong attention on the economy of different knowledges present in _software documentation_. How this exchange of resources could make place for different voices. - A collection of small devices to assist and stimulate the documentation process, with prompts and gently reminders that _software documentation_ is a form of care. @@ -31,8 +31,6 @@ _note: I'm using the words toolkit, handbook, map, collection of tools, practice _note: the plan is to use the different hackpacts and assignments as a way to bootstrap different directions for the research. Every hackpact is self contained and in effect is a different prototype, but it rarelly ends when a new one starts. Rather, with every new hackpact the old ones continue developing in the background with less intensity, but in concert, informing each other._ -_The different directions are: materiality of software documentation, actors of software documentation, economy of software documentation_ - `[Hackpact 1 - Define a domain of research]` Where does software documentation begin and where does it end? What about README files, tutorials, guidelines, comments in the source code, and demos? How porous or tentacular is this surface? Set some references by looking back at the works made last year and read them through the axis of code and care. Explore common templates of documentation and their habitability.