potiuk commented on PR #48760:
URL: https://github.com/apache/airflow/pull/48760#issuecomment-2781139438

   OK. I improve it way more. Rather than using sphinx commands directly, I 
repurposed the `docs_build.py` into a `doc-build` command line that you can use 
now to build documentation locally.
   
   ```bash
   cd FOLDER
   uv run --group docs build-docs 
   ```
   
   Then in order to get automatically refreshing server:
   
   ```bash
   cd FOLDER
   uv run --group docs build-docs --autobuild
   ```
   
   But also you can build several packages together (including solving updated 
cross-package doc  references) 
   
   ```bash
   uv run --group docs build-docs PACKAGE1 PACKAGE 2
   ```
   
   Or even build docs for all packages together (when run in the top directory):
   
   ```bash
   uv run --group docs build-docs
   ```
   
   The tool to build docs has now nice `rich-click` interface:
   
   <img width="1406" alt="build-docs" 
src="https://github.com/user-attachments/assets/a9623823-8099-4e26-965e-cb1313a37c32";
 />
   
   
   


-- 
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: commits-unsubscr...@airflow.apache.org

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

Reply via email to