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/06/03 23:07:21 UTC
[PR] AGENTS.md: golden rule — no newsfragment unless certain a change is user-facing [airflow]
potiuk opened a new pull request, #67982:
URL: https://github.com/apache/airflow/pull/67982
Agents (and contributors) keep adding newsfragments for changes that are not user-facing — build/release tooling, CI, internal refactors — which then have to be removed during review (e.g. on the reproducible-build dirty-check fix).
This makes the expectation explicit in `AGENTS.md` (and via the `CLAUDE.md` symlink): a newsfragment is only for changes that are *certainly* visible to users; when in doubt, omit it and let a maintainer request one in review. Strengthens the two existing newsfragment mentions into a clear golden rule rather than the previous "do not add by default" phrasing.
No behavior change — documentation/agent-guidance only.
---
##### Was generative AI tooling used to co-author this PR?
- [X] Yes — Claude Code (Opus 4.8)
Generated-by: Claude Code (Opus 4.8) 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] AGENTS.md: golden rule — no newsfragment unless certain a change is user-facing [airflow]
Posted by "potiuk (via GitHub)" <gi...@apache.org>.
potiuk commented on PR #67982:
URL: https://github.com/apache/airflow/pull/67982#issuecomment-4622643679
> Thanks, hoping this improves a lot in regards of false-positive newsfragments flooding PRs recently...
To be honest, this was quite interesting, I do not remmeber exactly how it came to being but it looks like I asked it for the newsfragment separately because it was separate commit. But definitely there is something with newsfragments that agents add them more often than needed - so being pretty explicit about it might help.
--
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] AGENTS.md: golden rule — no newsfragment unless certain a change is user-facing [airflow]
Posted by "potiuk (via GitHub)" <gi...@apache.org>.
potiuk merged PR #67982:
URL: https://github.com/apache/airflow/pull/67982
--
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