Standardize connection docs labels across providers

[harshith-21]

Tried to standardize howto/connection:{conn_type} labels in provider .rst docs to match provider.yaml connection-type values as suggested in following issue.

Closes: #63348

---

Was generative AI tooling used to co-author this PR?

• Yes (please specify the tool below)

Generated-by: Cursor/Claude following the guidelines

---

• Read the Pull Request Guidelines for more information. Note: commit author/co-author name and email in commits become permanently public when merged.
• For fundamental code changes, an Airflow Improvement Proposal (AIP) is needed.
• When adding dependency, check compliance with the ASF 3rd Party License Policy.
• For significant user-facing changes create newsfragment: {pr_number}.significant.rst, in airflow-core/newsfragments. You can add this file in a follow-up commit after the PR is created so you know the PR number.

[josh-fell]

There are some other places where there are multiple connection doc tags in providers. You should also make sure any other references in any of the docs that might reference the existing labels are updated too.

Looks like a good start on a cleanup effort!

[kaxil]

Also like we discussed on Slack (I think), please create a pre-commit/prek hook (or crete/update existing Sphinx extensions) to ensure it follows this convention

[harshith-21]

hi @kaxil, just to confirm: the pre-commit hook should make sure that the connection-type in provider.yaml, the title anchor in the corresponding .rst documentation file, and the references to it all use the same value, right ?

[kaxil]

hi @kaxil, just to confirm: the pre-commit hook should make sure that the connection-type in provider.yaml, the title anchor in the corresponding .rst documentation file, and the references to it all use the same value, right ?

Yup

[harshith-21]

hi @kaxil, ive added the prek hook which checks if the anchors and references are valid.
I was able to do a quick test with fake conn anchor which failed as follows,

Validate connection doc labels match provider.yaml.............................................Failed
- hook id: check-connection-doc-labels
- exit code: 1

  ✗ ORPHAN LABEL: providers/pgvector/docs/connections.rst — 'howto/connection:fake_conn_type' does not match any connection-type in provider.yaml
    ✗ MULTIPLE LABELS: providers/pgvector/docs/connections.rst — found 2 top-level labels (pgvector, fake_conn_type), expected at most 1

  Connection doc label check failed with 2 error(s).

[kaxil]

Could you rebase on main to see if it fixes CI errors

[kaxil]

CI failures: https://github.com/apache/airflow/actions/runs/23073391048/job/67029554773?pr=63455 that needs fixing

[potiuk]

nice !

[kaxil]

@harshith-21 🎉