Problem:
The icon buttons do not show any hint which action they are going to execute. So the user needs to either guess what will happen or to "learn" it by clicking on it - and with this possibly execute an unwanted action.
Solution:
Add either alt texts or tooltips that show on hovering over the buttons.
This addresses buttons like:
The Generated Client API is remains largely undocumented...
It would also be awesome if we could include the documentation of the API in the Generated DSL
Currently the model namespace keeps track of registered models and creates maps for "quick" mapping (e.g. mapping a model field to table column). This is mainly for performance benefits.
These maps are stored in atoms. However it might be nice to actually store then in `^:dy
Add a description, image, and links to the data-driven topic page so that developers can more easily learn about it.
To associate your repository with the data-driven topic, visit your repo's landing page and select "manage topics."
Swagger feature docstring (and spec?) places tags on route-data root:
https://github.com/metosin/reitit/blob/master/modules/reitit-swagger/src/reitit/swagger.cljc#L55
Examples place tags key under swagger:
https://github.com/metosin/reitit/blob/master/examples/ring-swagger/src/example/server.clj#L30
Both seem to generate proper swagger.json, but first one fails spec validation. Why? Sp