john-bodley opened a new pull request #9833: URL: https://github.com/apache/incubator-superset/pull/9833
### SUMMARY This PR fixes an issue which surfaced in https://github.com/apache/incubator-superset/pull/9824 with Sphinx when an auto-doc included a forward reference via `TYPE_CHECKING`. The fix is to `set_type_checking_flag = True` in the Sphinx configuration however this raised additional warnings such as `cannot import name 'ArrayLike'` and `cannot import name 'security_manager'`. After a decent amount of Googling it's uncertain what the root cause is, but it seems importing these modules into `docs/conf.py` resolves the issue. ### BEFORE/AFTER SCREENSHOTS OR ANIMATED GIF <!--- Skip this if not applicable --> ### TEST PLAN Successfully ran `tox -e docs` and verified that the generated HTML was correct. ### ADDITIONAL INFORMATION <!--- Check any relevant boxes with "x" --> <!--- HINT: Include "Fixes #nnn" if you are fixing an existing issue --> - [ ] Has associated issue: - [ ] Changes UI - [ ] Requires DB Migration. - [ ] Confirm DB Migration upgrade and downgrade tested. - [ ] Introduces new feature or API - [ ] Removes existing feature or API ---------------------------------------------------------------- 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: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
