You are viewing a plain text version of this content. The canonical link for it is here.

Posted to commits@airflow.apache.org by GitBox <gi...@apache.org> on 2021/05/18 10:32:26 UTC

[GitHub] [airflow] ashb opened a new issue #15917: Redoc API docs show mis-leading/wrong examples for what fields are updateable

ashb opened a new issue #15917:
URL: https://github.com/apache/airflow/issues/15917


   For example on https://airflow.apache.org/docs/apache-airflow/2.0.2/stable-rest-api-ref.html#operation/patch_dag the example on the right shows updating a schedule_interval, but that is not possible.
   
   ![image](https://user-images.githubusercontent.com/34150/118635899-04ff8c80-b7cc-11eb-807a-6f0a1f309a90.png)
   
   Redoc also doesn't show anywhere what fields on the DAG model are actually updatable, 
   
   Unlike the Swagger docs, which is less "pretty" but actually correct
   
   ![image](https://user-images.githubusercontent.com/34150/118636501-ac7cbf00-b7cc-11eb-87df-29aa47441877.png)
   
   


-- 
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.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

[GitHub] [airflow] ashb commented on issue #15917: Redoc API docs show mis-leading/wrong examples for what fields are updateable

Posted by GitBox <gi...@apache.org>.

ashb commented on issue #15917:
URL: https://github.com/apache/airflow/issues/15917#issuecomment-843056206


   Already reported upstream as https://github.com/Redocly/redoc/issues/1238


-- 
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.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org