documentation!

thumb
km0 2 years ago
parent d76cdd9db5
commit 252e39999a

@ -13,9 +13,20 @@ title: Graduation Project Proposal
## Draft Project Proposal ## Draft Project Proposal
Research on software documentation as an interface between code, users, developers, communities, and the world.
Explore documentation from the perspective of software as a form of care.
Documenting software it's a difficult and delicate practice.
Writing documentation it's more difficult than writing software itself.
It requires a lot of time and energy, and it involves many different skills: writing, coding, knowing how to share and at which intensity.
As some piece of code would write: I am documented, therefore I am.
Undocumented software is invisible, but for the eyes of their own developers. And eventually, it begins to fade as soon as the developer looks away.
### What do you want to make? ### What do you want to make?
Writing software as a form of care instead of a form of control. Writing software as a form of care.
What kind of resources, experiences and approaches constitute this practice? What kind of resources, experiences and approaches constitute this practice?
@ -157,9 +168,11 @@ The practical aspect depends on the second and third case studies. There are som
Tut with Joseph Tut with Joseph
galloway galloway protocol
situated software, https://www.gwern.net/docs/technology/2004-03-30-shirky-situatedsoftware.html situated software, https://www.gwern.net/docs/technology/2004-03-30-shirky-situatedsoftware.html
post-meritocratic manifesto post-meritocratic manifesto
josep weizenbaum josep weizenbaum
Tut with Manetta
--- ---

@ -178,3 +178,4 @@ _some notes for the project:_
- Padliography category page on the wiki, with the same contents of the README.md and a list of the archives page. - Padliography category page on the wiki, with the same contents of the README.md and a list of the archives page.
- Now when the padliography initialize a new archive, it adds the `[[category: padliography]]` tag, in order to list all the active archives in the category page. - Now when the padliography initialize a new archive, it adds the `[[category: padliography]]` tag, in order to list all the active archives in the category page.
- Next step is: how to make it public?

Loading…
Cancel
Save