potiuk commented on PR #48223: URL: https://github.com/apache/airflow/pull/48223#issuecomment-2768076311
OK. The simplest way to solve docs building .... was to fix it finally. There are still few missing links to be updated so part of the docs will fail (I am going to slep now after long night fighting it) but I FINALLY made it the way doc building should be made: * each package has its own - WAY simpler conf.py file * providers have a single povider_conf.py they import from `devel-common` * common configuration and code is imported from `devel-common` as well -there is very little duplication but also the non-provider packages have their own "docs.conf" that describes their configuretion in isolation with others - no more complicated and convoluted if's in the `conf.py` * you should be able to easily run docs building locally with uv - separately for each package - but I will do all the docs and testing and instructions as a follow-up. In principle we should also be able to use `sphinx-autobuild` and have auto-refreshable document editing in-place (!!!!!!!!!!!!) A lot of code is modernised and simplified along the way. -- 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]
