You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@airflow.apache.org by "potiuk (via GitHub)" <gi...@apache.org> on 2026/03/10 22:12:25 UTC
[PR] Split PROVIDERS.rst into focused documents under providers/ [airflow]
potiuk opened a new pull request, #63305:
URL: https://github.com/apache/airflow/pull/63305
Split the monolithic `PROVIDERS.rst` into focused documents under the `providers/` folder,
alongside the existing `MANAGING_PROVIDERS_LIFECYCLE.rst`.
## Summary
- Keep `PROVIDERS.rst` as a concise hub with overview, document index table, and stub sections
preserving all existing anchor links (used by hundreds of changelog files)
- New documents under `providers/`:
- `PROVIDER_GOVERNANCE.rst` - governance framework, stewardship, lifecycle stages, health metrics
- `ACCEPTING_PROVIDERS.rst` - prerequisites and approval process for new providers
- `PROVIDER_RELEASES.rst` - release process, SEMVER versioning, distribution states, min Airflow version
- `SUSPENDING_AND_REMOVING_PROVIDERS.rst` - suspension and removal criteria/process
- `THIRD_PARTY_PROVIDERS.rst` - 3rd-party providers and mixed governance model
- Restructured `MANAGING_PROVIDERS_LIFECYCLE.rst` with consistent heading hierarchy and logical
section grouping (creating, releasing, suspending, resuming, removing)
- Updated all cross-references between documents
## Test plan
- [ ] Verify all existing anchor links from changelog files still resolve correctly
- [ ] Verify cross-references between the new documents work
- [ ] Build docs with `breeze build-docs apache-airflow` to check for broken links
---
##### Was generative AI tooling used to co-author this PR?
- [X] Yes — Claude Opus 4.6
Generated-by: Claude Opus 4.6 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: commits-unsubscribe@airflow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Split PROVIDERS.rst into focused documents under providers/ [airflow]
Posted by "potiuk (via GitHub)" <gi...@apache.org>.
potiuk commented on PR #63305:
URL: https://github.com/apache/airflow/pull/63305#issuecomment-4034807689
Should be way easier to navigate, understand and point people to
--
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-unsubscribe@airflow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Split PROVIDERS.rst into focused documents under providers/ [airflow]
Posted by "potiuk (via GitHub)" <gi...@apache.org>.
potiuk merged PR #63305:
URL: https://github.com/apache/airflow/pull/63305
--
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-unsubscribe@airflow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Split PROVIDERS.rst into focused documents under providers/ [airflow]
Posted by "jscheffl (via GitHub)" <gi...@apache.org>.
jscheffl commented on code in PR #63305:
URL: https://github.com/apache/airflow/pull/63305#discussion_r2914990217
##########
providers/MANAGING_PROVIDERS_LIFECYCLE.rst:
##########
@@ -15,83 +15,67 @@
specific language governing permissions and limitations
under the License.
-
**The outline for this document in GitHub is available at top-right corner button (with 3-dots and 3 lines).**
-Provider Governance Overview
-============================
+Managing Provider's Lifecycle
+==============================
Review Comment:
Too late but underline nit :-D
```suggestion
=============================
```
--
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-unsubscribe@airflow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org