brainstorm list

master
km0 2 years ago
parent 3be2586194
commit e2bcce6756

@ -1,5 +1,3 @@
sorry i will write the readme later teh school is closing
# compiling the list
![the list](cover.png)
@ -12,6 +10,8 @@ Add a new file in the `txt` folder! The format is Markdown, so use the `.md` for
For example:
`grocery.md`
```markdown
- Bread
- Milk

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

Loading…
Cancel
Save