omkar-foss commented on PR #65423:
URL: https://github.com/apache/airflow/pull/65423#issuecomment-4495832898

   We could simply have error meta in exc doc string (Sphinx-parseable) -
   
   ```python
   class AirflowNotFoundException(AirflowException):
     """Raise when the requested object/resource is not available...
      
       :User-facing error message: "Requested resource was not found"
       :Description: "This error occurs when Airflow is unable to locate..."
       :First steps: "Verify that the requested..."
       :Documentation: "https://airflow.apache.org/docs/...";
     """
   ```
   
   No error mixin or additional properties, just plain doc string used to
   generate doc page for exception classes. Breaking changes won't be
   required and support for providers will come out of the box with doc
   string.


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