|
|
|
|
@ -7,7 +7,8 @@
|
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
- Target public
|
|
|
|
|
- people in small communities that deal with software
|
|
|
|
|
- people in small communities
|
|
|
|
|
- related to software
|
|
|
|
|
- _Examples_
|
|
|
|
|
- Soupboat
|
|
|
|
|
- Breadcube
|
|
|
|
|
@ -30,11 +31,11 @@
|
|
|
|
|
|
|
|
|
|
- It's tricky!
|
|
|
|
|
- 🤧
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
- There is no such a thing as a magic solution for perfect documentation
|
|
|
|
|
- While there are documentation frameworks that help naming and structuring things, these usually cover just generic approach for technical writing
|
|
|
|
|
- While there are documentation frameworks that help naming and structuring things
|
|
|
|
|
- these usually cover just generic approach for technical writing
|
|
|
|
|
- Situated software has more to offer than a generic approach
|
|
|
|
|
- sprouting from specific contexts
|
|
|
|
|
- it can depend on particular knowledges and skills
|
|
|
|
|
@ -42,9 +43,10 @@
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
- This diversity means manifold of ideas and ways to document
|
|
|
|
|
- Hence a list of resources
|
|
|
|
|
- Someone would call it site specific software
|
|
|
|
|
- This diversity means
|
|
|
|
|
- manifold of ideas and ways to document
|
|
|
|
|
- hence a list of resources
|
|
|
|
|
- someone would call it site specific software
|
|
|
|
|
- someone else situated knowledges
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
|
@ -89,3 +91,37 @@
|
|
|
|
|
- _again_ could this be something different than a website?
|
|
|
|
|
- actually and ideally
|
|
|
|
|
- every instance could decide on the form
|
|
|
|
|
- more like a mesh
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
- So what is this?
|
|
|
|
|
- A social network in the fediverse?
|
|
|
|
|
- A federated code of conduct?
|
|
|
|
|
- An entangled soup of documentation resources?
|
|
|
|
|
- I don't know yet
|
|
|
|
|
|
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
- But what i can imagine is a process:
|
|
|
|
|
- _1_
|
|
|
|
|
- Starting super small
|
|
|
|
|
- We
|
|
|
|
|
- (XPUB2 + me)
|
|
|
|
|
- write some documentation around the Soupboat
|
|
|
|
|
- collecting resources
|
|
|
|
|
- experimenting techniques
|
|
|
|
|
- taking care
|
|
|
|
|
- _2_
|
|
|
|
|
- (around march?)
|
|
|
|
|
- the system is offered to others
|
|
|
|
|
- that means either
|
|
|
|
|
- giving workshops
|
|
|
|
|
- or just showcasing the soupboat
|
|
|
|
|
- inviting other communities to try it as well
|
|
|
|
|
- (xpub1)
|
|
|
|
|
- (that autralian collective)
|
|
|
|
|
- (varia)
|
|
|
|
|
- etc
|
|
|
|
|
- _3_
|
|
|
|
|
- let's see
|
|
|
|
|
|
