Skip to content

Commit

Permalink
Update why.rst
Browse files Browse the repository at this point in the history
Just was reading the docs and found a few typos.
  • Loading branch information
davidhariri authored and gtmanfred committed Mar 27, 2024
1 parent bbe459f commit f81c59c
Showing 1 changed file with 2 additions and 2 deletions.
4 changes: 2 additions & 2 deletions docs/why.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ There are number of packages out there that solve a similar problem. Here are ju
* `flask-apispec <https://github.com/jmcarp/flask-apispec>`_
* `Flasgger <https://github.com/rochacbruno/flasgger>`_

These are all great projects, and one might work better for your use case. Flask-Rebar solves a similar problem with its own its own twist on the approach:
These are all great projects, and one might work better for your use case. Flask-Rebar solves a similar problem with its own twist on the approach:

Marshmallow for validation *and* marshaling
-------------------------------------------
Expand All @@ -23,7 +23,7 @@ Swagger as a side effect

Some approaches generate code *from* a Swagger specification, or generate Swagger from docstrings. Flask-Rebar aims to make Swagger (a.k.a. OpenAPI) a byproduct of writing application code with Marshmallow and Flask.

This is really nice if you prefer the rich validation/transformation functionality of Marshmallow over Swagger's limited.
This is really nice if you prefer the rich validation/transformation functionality of Marshmallow over Swagger's more limited set.

It also alleviates the need to manually keep an API's documentation in sync with the actual application code - the schemas used by the application are the same schemas used to generate Swagger.

Expand Down

0 comments on commit f81c59c

Please sign in to comment.