Interest in taking Schema description from Schema.__doc__ docstring

[ddorian]

You take the object description from Meta.description in

apispec/src/apispec/ext/marshmallow/openapi.py

Line 260 in 8cbbbeb

jsonschema["description"] = Meta.description

Do you have interest in a pull request to also get it from the Schema docstring? Something like:

if hasattr(Meta, "description"):
    jsonschema["description"] = Meta.description
elif schema.__doc__:
    jsonschema["description"] = schema.__doc__

You can do the same formating as in https://flask-smorest.readthedocs.io/en/latest/openapi.html#add-summary-and-description.

Makes sense?