mik-laj commented on pull request #17174:
URL: https://github.com/apache/airflow/pull/17174#issuecomment-949419378


   > Is there any drawback of listing all the schemes under security? (Apart 
from having to keep that list in sync with all securitySchemas defined)
   
   Yes. The API specification and API documentation will display incomplete 
information which will be confusing. Now we have a custom section that explains 
authentication. 
http://airflow.apache.org/docs/apache-airflow/stable/stable-rest-api-ref.html#section/Authentication
   If we add to the specification, a new section will be added which will be 
incomplete/invalid. Here is example: 
   
https://redocly.github.io/redoc/?url=https://petstore.swagger.io/v2/swagger.json
   
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


Reply via email to