Jérôme Lafréchoux

Thanks for the feedback. I see several options - Create a new decorator that would be an alias to `arguments` with `as_kwargs` set to `True` (your suggestion). - Add a...

I think this is a marshmallow issue. strict is always True in marshmallow 3. If you're starting a new project, you could try to use marshmallow 3. If you're stuck...

@revmischa I'm open to adding a `kwarguments` decorator. Would you like to submit a PR?

@dougthor42, nope. flask-rest-api and apispec mean to actually use the features defined in the OpenAPI spec. Cramming all information in the "description" field in an unstructured way defeats the point...

@aiham This looks like a legit use case. I didn't know about that OAS feature. We could try to add a feature to provide default unique IDs based on blueprint/route/endpoint/method...

Obviously, another option is to keep the doc decorator as it is and document what it should not be used for. It sounds a bit cheap and dirty, but it...

Thanks for the valuable feedback, really. Yeah, I guess trying to cover every feature explicitly in this lib is a chimera. Ultimately, we're probably gonna keep `doc`. In its current...

Ah, OK. We do the same but instead of calling `doc`, we manipulate the `_apispec` attribute directly. As I wrote above, making this the recommended way would require this attribute...

Sorry for the delay. Thanks to user feedback and own experience, my mind is moving towards keeping this decorator in a form or another. As I wrote above, for the...

Perhaps [this SO post](https://stackoverflow.com/a/30714299) or [this one](https://stackoverflow.com/a/13503277) would help. Keeping this for later.