[FLINK-39714][docs] Backport AGENTS.md and AI disclosure#28204
Merged
Conversation
Brings AGENTS.md and the AI disclosure section of the PR template to this release branch so AI coding agents working on backports find the same conventions they get on master. Content sourced verbatim from current apache/master, which combines: - FLINK-39477 (master commit 55d0cc6, also on release-2.3 as 8aba8c9): initial introduction of AGENTS.md and the AI disclosure section of .github/PULL_REQUEST_TEMPLATE.md. - FLINK-39623 (master commit d1e3d13): later AGENTS.md additions (the "Codegen vs hand-written operators" bullet under Architecture Boundaries, and the "Release Notes" bullet under Pull request conventions). These have not yet been backported to release-2.3. This commit does not use git cherry-pick because the desired content combines two separate master commits; the references above record the original sources. Generated-by: Claude Opus 4.7 (1M context)
Removes references to modules and files that exist on master but not on release-1.20, and corrects the Java version statement to match this branch. - Java prerequisites (line 26): default is Java 8 (deprecated) per release-1.20 pom.xml (target.java.version=1.8); Java 11 is the recommended runtime per docs/content/docs/deployment/java_compatibility.md; Java 17 is still experimental on this line. Java 21 is not documented for release-1.20, so remove it from the prerequisites list. - flink-metrics-otel: not present on release-1.20; drop from the metrics reporter implementations bullet. - flink-models (and sub-modules flink-model-openai, flink-model-triton): not present on release-1.20; drop the bullet under "Other". - DEVELOPMENT.md: introduced by FLIP-561 (master commit ccaa2eb), not backported to release-1.20; drop the link from References. Generated-by: Claude Opus 4.7 (1M context)
liuml07
changed the title
Collaborator
raminqaf
approved these changes
May 20, 2026
Contributor
raminqaf
left a comment
raminqaf
left a comment
There was a problem hiding this comment.
LGTM! Thanks for the backport!
github-actions
Bot
added
the
community-reviewed
snuyanzin
approved these changes
May 20, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What is the purpose of the change
Backport of AGENTS.md and the AI disclosure section of pull request template to
release-1.20, so AI coding agents working on backports here find the same conventions they get onmaster.Brief change log
AGENTS.mdand the PR template additions verbatim from current master (FLINK-39477 + FLINK-39623).AGENTS.mdto this release branch — drop references to modules/files that don't exist here (e.g.,flink-models,flink-metrics-otel,DEVELOPMENT.md, and where relevant the Java prerequisite line).Follows up on review feedback from #28179.
Verifying this change
This change is a trivial rework / code cleanup without any test coverage.
Does this pull request potentially affect one of the following parts:
@Public(Evolving): (yes / no)Documentation
Was generative AI tooling used to co-author this PR?
Generated-by: Claude Opus 4.7 (1M context)