gp polish

thumb
km0 2 years ago
parent dfecf6c2ed
commit c240ee1786

@ -17,14 +17,15 @@ _note: I'm using the words toolkit, handbook, map, collection of tools, practice
### What do you want to make? ### What do you want to make?
- An extensible toolkit to explore _software documentation_ as publishing surface. - An extensible toolkit to explore _software documentation_ as publishing surface in 3d: its materiality, the actors involved and the economy surrounding it.
- A set of tools and practices that focus on _software documentation_ as an interface between code, users, developers, communities, and the world.
- 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 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, not just a source of profit. - 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.
- A series of writing prompts to experiment with _software documentation_ as a generative device to keep thinking through code from different perspectives. - A series of writing prompts to experiment with _software documentation_ as a generative device to keep thinking through code from different and marginal perspectives.
- A way to understand publishing as iterative process, as a format that grows and shrinks through versioning and embrances branching to adapt to specific environments. - A way to understand publishing as iterative process, as a format that grows and shrinks through versioning and embrances branching to adapt to specific environments.
- A (loose, habitable, extensible) map to orientate around what does it mean to _make software_ besides just writing code. - A (loose, habitable, extensible) map to orientate around what does it mean to _make software_ besides just writing code.
- A writing machine to build world around software. - A writing machine to build worlds around software.
- A set of tools and practices that focus on _software documentation_ as an interface between the code, the user, the developer, the community, and the world.
### How do you plan to make it? ### How do you plan to make it?

Loading…
Cancel
Save