Improved Swagger Docs
1. endpoints are alphabetized (lexicographical is *always* the wrong order.) I'd like to group by concept
2. /docs/{id}/tables/{id}/rows/{id} groups the entire endpoint under `doc`, but clearly it's an action a user would search for under `row`. Similar to #1, I want to group my own way
3. Lack of exposition. I'd like to be able to write a bit more about what each endpoint does. Is there a place to do that other than in Query description settings? I want to write a *lot*.
4. Typeface size and consistency. A lot of the text is too small to comfortably read, and it's is all over the place in size (I count at least 8 different text sizes. I want no more than 4) Can I customize the css?
Working with APIs
2 replies