an amazing image and some indexing

main
km0 2 years ago
parent 86a65f69a4
commit 6ae86356ed

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

@ -23,3 +23,27 @@ Could software documentation:
How can situated practices inform the process of documenting software?
And how can situated software inform the process of technical writing?
## Table of contents (draft)
The thesis is composed of different texts: some provide context and critical background to situate the research, while others consist in experiments of actual documentation written for software developed within our course.
Every piece of documentation will try to reflect on different aspects.
![exploratory documentation aspects + 2 frogmouth birds](img/frogmouth_aspects.jpg)
More precisely these four aspects will be addressed:
- **Tone and style**
How to make a documentation more accessible? How to create multiple entry points in a complex topic? How to address different kind of users, and not just a generic one?
- **Participation**
Who gets to write, and who is forced to do it? How does development and technical writing interact? Is technical writing a subaltern position in the industry of software development?
- **Destination**
Who can read documentation? Who can access? Where is the documentation hosted? How does it relate with a bigger context, if any?
- **Susteinability**
How to face the lack of resources when approaching technical writing? Strategies to share workloads and collaboration. Strategies to take care of shared piece of software.
The critical and theoretical research will be weaved around the actual documentations, in order to create a discourse around the development of this practice.

Loading…
Cancel
Save