From 5dc499cd4f4f5f41a8abfe9fed40054035cf9e08 Mon Sep 17 00:00:00 2001 From: "kam (from the studio)" Date: Wed, 1 Feb 2023 20:48:33 +0100 Subject: [PATCH] surface ? ? ? what does it mean --- chapters/02_economy.md | 18 ++++++++++++++++++ chapters/03_world.md | 4 +++- 2 files changed, 21 insertions(+), 1 deletion(-) diff --git a/chapters/02_economy.md b/chapters/02_economy.md index 4701ed3..8c76a20 100644 --- a/chapters/02_economy.md +++ b/chapters/02_economy.md @@ -1,3 +1,21 @@ _can documentation trigger different kinds of economy around software?_ - 360 degrees of proximity + +--- + +Software documentation comes in different formats. + +The Díataxis framework (Procida, 2017) maps them into four main quadrants using a systematic approach. It focuses on four main needs of the user: to learn, to understand, to get the work done, and to gather specific informations. + +In this thesis the term documentation is less structured: it tries to encompass different forms of care. Instead of prescribing the recipe for a perfect solution, it attempts to describe a surface, and ways to navigate it. + +Expanding the four quadrants, mixing them we can include transversal practices like that proposed for _360 degrees of proximity_. + +--- + +not a rigid framework +but a surface: a set of practices +something to be negotiated and expanded + +example: a practice that gets instantiated in the form of workshop (_360 degrees of proximity_) diff --git a/chapters/03_world.md b/chapters/03_world.md index d5114f5..b83eae0 100644 --- a/chapters/03_world.md +++ b/chapters/03_world.md @@ -1,4 +1,6 @@ -_be an ideal surface to build worlds?_ +_can documentation be an ideal surface to build worlds?_ - the screenless office - ian cheng + +---