gabek / fedidocs

Documentation for the Fediverse
https://fedidevs.org/
Creative Commons Attribution Share Alike 4.0 International
39 stars 13 forks source link

Tackling protocol decay and tech debt #17

Open aschrijver opened 1 year ago

aschrijver commented 1 year ago

In chat there's mention about the huge tech debt on the Fediverse, and how to ensure interop. I'd just like to highlight some docs of the Evolvability, Deployability, & Maintainability (edm) working group at the IETF, that have some guidelines and highlight forces that cause the debt/decay:

Can be handy as input for doc guidelines, and also to discuss other specific ways to get rid of the tech debt, and help restrict scope of FediDocs initiative.

jernst commented 1 year ago

I'm not clear how this is "actionable". In other words, what would it take for this issue to be closed as fixed?

aschrijver commented 1 year ago

I posted this as follow-up to discussion on "What will be our scope and work methods?", and that leaning to the existing fediverse and decreasing tech-debt. I do not see that described yet in this repo. Until then I see this as input to "What is our purpose and goal?" and insights from these docs may find their way for guidance and practices for participating in this group.