@dumpsterqueer@ondergrond.org hmm swagger is nice for when you just need info on some specific routes, but generally I prefer full documentation (with route documentation) like the new https://spec.matrix.org because it provides a lot more space for rationale/extra explanations. In practice I use both for Matrix things (they have Swagger too)