Prompt
Documentation tooling and configuration files should leverage shared/centralized resources rather than maintaining duplicate copies across repositories. This reduces maintenance burden, ensures consistency, and simplifies updates.
Examples:
- For dependencies, prefer pyproject.toml over separate requirements files:
# Instead of separate requirements.txt files: # sphinx>=5.0 # sphinx-autoapi>=1.8 # sphinx-airflow-theme>=0.2.2 # Use pyproject.toml with direct references when needed: [project.optional-dependencies] docs = [ "sphinx>=5.0", "sphinx-autoapi>=1.8", "sphinx_airflow_theme @ https://github.com/apache/airflow-site/releases/download/0.2.3/sphinx_airflow_theme-0.2.3-py3-none-any.whl", ] - For configuration files like spelling wordlists, reference common resources:
# Use shared mechanism instead of duplicating large wordlists # uv run --group docs build-docs # (will automatically use common spelling exclusion file from `airflow/docs`)
This approach ensures documentation tools stay consistent across projects and simplifies maintenance when standards change.