violetweather opened a new pull request, #73667:
URL: https://github.com/apache/airflow/pull/73667
closes: #10260
## Human Summary
Fixes gray names into clickable links, built the docs locally and tested
## AI Summary
<details><summary>Click here</summary>
Guides across the core docs named configuration options and sections as
plain inline literals (for example ``` ``sentry_on`` option in the ``[sentry]``
section ``` or ``` ``[core] dags_folder`` ```), so readers had to look them up
in the configuration reference by hand. The `config:<section>` and
`config:<section>__<option>` labels generated for the configuration reference
already exist, and about 90 places in the docs already use them. This PR
converts the remaining plain mentions to `:ref:` links in the same style the
docs already use, e.g. `` :ref:`[api] secret_key <config:api__secret_key>` ``.
Scope and choices:
- 140 lines in 47 files under `airflow-core/docs`, docs-only.
- Only options and sections that exist in
`airflow-core/src/airflow/config_templates/config.yml` are linked; all 84
distinct link targets were checked against it.
- Left as plain text on purpose:
- Provider-owned sections (`[celery]`, `[fab]`): their reference pages
live in the provider docs, so linking them needs cross-package intersphinx
refs. This is better done in a follow-up.
- `[mysqld]` (a MySQL server setting, not an Airflow one).
- `[task_state_store]` in the note that says the section is **not** called
that.
- Section headings and literal/code blocks.
- `smtp_password`, which has no entry in `config.yml`. Its `[smtp]`
section is linked.
Checks run:
- `python -m docs.build_docs --package-filter apache-airflow --docs-only`
inside the CI image (`ghcr.io/apache/airflow/main/ci/python3.10`): build
successful, no warnings.
- `prek` pre-commit hooks on commit: passed.
- `prek run --stage manual` (with the skips listed in AGENTS.md): passed.
</details>
---
##### Was generative AI tooling used to co-author this PR?
- [X] Yes — Claude Code (Opus 5.5)
Generated-by: Claude Code (Opus 5.5) following [the
guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#gen-ai-assisted-contributions)
--
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]
