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 + +---