You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
When generating API documentation for various drivers using sphinx, tons and tons of warnings are printed due to an invalid docstring syntax in many places.
Those syntax issues should be fixed and once all the issues are fixed, sphinx and RTD config should be update to fail on warning. This way we will detect such issues early as part of CI.
Keep in mind that those fixes mostly can't be automated and it will be manual laborious and time intensive task.
The text was updated successfully, but these errors were encountered:
The biggest offender by far (hundreds of errors) is the Outscale compute driver.
To make this task more manageable, I think it makes a lot of sense to simply exclude Outscale driver from the API docs generation and focus on fixing syntax issues everywhere else to begin with.
When generating API documentation for various drivers using sphinx, tons and tons of warnings are printed due to an invalid docstring syntax in many places.
Those syntax issues should be fixed and once all the issues are fixed, sphinx and RTD config should be update to fail on warning. This way we will detect such issues early as part of CI.
Keep in mind that those fixes mostly can't be automated and it will be manual laborious and time intensive task.
The text was updated successfully, but these errors were encountered: