- 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
- Target public - people in small communities that deal with software - _Examples_ - Soupboat - Breadcube - XPUB - Varia - OSP - Konstant - Autonomic - 100R - etc
- Why a space? - Why a list? - Why resources? - Why not just a manual on how to write the perfect software documentation?
- 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 - 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
- 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
- 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
- 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?
- _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