No way to add description to path parameters

I can’t see any way to add a description to a path parameter. Using the @blp.doc decorator as in:

    @blp.doc(parameters=[{"name": "thing_id", "description": "The ID of the thing"}])

just results in adding another parameter with a duplicate name and only a description. I have a local fix for this in FlaskPlugin where I just scan the existing parameters and update rather than append if I find one with the same name. I can get this into a PR unless you have another way you’d rather approach this?

[congenica-andrew]

Well, for what it’s worth, here https://github.com/congenica-andrew/flask-rest-api/commit/fe427b1529f04b547937625fa27c163c8d1819e4 is what I have already.

[lafrech]

Good.

I think my rationale here was that:

• It fails at init, not at runtime, so the error is caught be the developer.
• Using @blp.doc is a last resort, so it will always be rough along the edges. It provides access to the internals. Let’s not try to do too much checks in there, but rather, let’s provide nice interfaces so that developers don’t need it in the first place.

Ultimately, I’d rather have a nicer way of passing path params doc. I would have liked to avoid yet another decorator, but I’m afraid this is the least awkward solution identified for now.