diff --git a/README.md b/README.md index 3fd8e21..50020dd 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/txt/brainstorm.md b/txt/brainstorm.md index 3290c7e..cf8f8ca 100644 --- a/txt/brainstorm.md +++ b/txt/brainstorm.md @@ -7,7 +7,8 @@
- 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! - 🤧 - -
+
- 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 @@
-- 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
@@ -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 + +
+ +- 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 + +
+ +- 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