luciano/reitit
1
0
Fork 0
mirror of https://github.com/metosin/reitit.git synced 2025-12-16 16:01:11 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

doc: swagger reusable schema definitions supported only for malli

Browse source
This commit is contained in:
Joel Kaasinen 2024-11-28 09:56:02 +02:00
parent 431242c926
commit fc132f3a92
1 changed files with 11 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
doc/ring/swagger.md
View file

@ -286,7 +286,17 @@ Example with:
; ("/common/ping" "/one/ping" "/two/ping" "/two/deep/ping")
```
### TODO
## Reusable schema definitions
Swagger supports having reusable schema definitions under the
`"definitions"` key. These can be reused in different parts of
swagger.json using the `"$ref": "#/definitions/Foo"` syntax.
Reusable schema objects are generated for Malli `:ref`s and vars.
Currently (as of 0.7.2), reusable schema objects are **not** generated
for Plumatic Schema or Spec.
## TOD
* ClojureScript
* example for [Macchiato](https://github.com/macchiato-framework)