externalDocs for operation schema

[Jusstas]

I have missed the externalDocs field for the operation object. Is there any intended way I can add this for my views? If not, I think there should be an external_docs argument in the extend_scema (and extend_schema_serializer I guess?) decorator for this purpose.

[tfranzel]

There is a dedicated setting for this (among most other possible settings):

drf-spectacular/drf_spectacular/settings.py

Line 180 in 66086cf

'EXTERNAL_DOCS': {},

Other settings for the root object can be added with EXTENSIONS_ROOT

[Jusstas]

As I understand, the EXTERNAL_DOCS setting is only for the root OpenAPI object, but there are also externalDocs fields for operation and schema objects.

[tfranzel]

Excellent point! Sry, I missed that you were referring to the operation.

Should be doable, however not sure yet where exactly it is the best fit. operation or schema objects.

[tfranzel]

That should do it. It is only for the operation for now. Let's wait if someone will ask for the schema object.

[tfranzel]

closing this issue for now. feel free to comment if anything is missing or not working and we will follow-up.