You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

92 lines
2.4 KiB
Markdown

2 years ago
- Create a space
- to host a list of resources
- to explore the documentation of coding related practices
- for situated software
- and articulate it as a form of care
<br>
- Target public
- people in small communities that deal with software
- _Examples_
- Soupboat
- Breadcube
- XPUB
- Varia
- OSP
- Konstant
- Autonomic
- 100R
- etc
<br>
- Why a space?
- Why a list?
- Why resources?
- Why not just a manual on how to write the perfect software documentation?
<br>
2 years ago
- It's tricky!!
- 🤧
2 years ago
<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
- Situated software has more to offer than a generic approach
- sprouting from specific contexts
- it can depend on particular knowledges and skills
- that differ in each community
<br>
- 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>
- Different resources come from different communities
- It is not guaranted for them to be interchangeable
- nor to be effective or either meaningful for everyone else
- Yet, to be together in this list could be a way to interfere with each other
- To create perspective and inspire new strategies
<br>
- So the need for a space where to host the list
- What are the feature of this space?
- Open to contributions
- A bit structured
- A bit loose
- Is it a platform?
- Could it be something different than a website?
- Could it work without browser's technology?
- Could it have less environmental impact?
- Could it be simple and lightweight?
- Could it inhabit existing documentations?
- A strange hyper tagging system?
<br>
- _Idea_
- Federated list
- should it follow the concepts of the Fediverse?
- several instances of this list
- growing from specific groups or cluster of groups
- each community curates it's own list
- this is interesting
- is it different from a normal feed?
- yes
- because the contents are curated
- not just aggregated
- how is it structured?
- each instance has a server
- and offer access for clients
- _again_ could this be something different than a website?
- actually and ideally
- every instance could decide on the form