Repository navigation
[v3-4-test] Java SDK: Rewrite the user docs around Dag definition (#74701) - #75439
Merged
jason810496 merged 1 commit intoOct 23, 2026
Merged
Conversation
* Java SDK: Rewrite the user docs around Dag definition Reorder the Java SDK guide to start from a Dag defined in Java, document conditions, switches and TriggerDagRun, and add a table of how stub task arguments bind. Split the README into a user landing page and DEVELOPMENT.md, and add an example README. * Add Logback and appender to the docs spelling wordlist * Address review: Dag-level queue, version sync, dropped constraints Set the queue once on the Dag in every example, now that a Java Dag takes one, and bump the documented version to 1.0.0-beta2 everywhere. Add a prek hook that fails when the guide, the README and the Dokka landing page name different versions. Restore the TaskInput constraints, correct the LocalExecutor wording, and drop the Python Label comparison. * Generate the quick start of the Java SDK README and Dokka page The quick start appears on three pages. The guide owns it now, between SHARED SNIPPET markers, and the sync-java-sdk-docs hook copies it into the other two and still checks that all three install the same version. * Address review: install a version placeholder, not a release The three pages that show how to install the SDK pinned a release that is not out yet, which also held the PR back. They now install `<version>` and link to Maven Central, and the sync hook fails when a page names a release instead. The parse-failure bullet leads with the SDK release a JAR was built with, and keeps the supervisor schema version as the explanation. --------- (cherry picked from commit a419633)
jason810496
requested review from
amoghrajesh,
ashb,
bugraoz93,
gopidesupavan,
jscheffl,
potiuk and
uranusjr
as code owners
October 23, 2026 04:29
1 task done
jason810496
added a commit
that referenced
this pull request
Oct 23, 2026
This reverts commit eda782f. Since it merged, the K8S Lang-SDK test has hung in about 40% of CI runs: a Java task stops right after its first request to the supervisor and stays running until the test times out. Every run before the merge passed. Reverting keeps CI usable while the hang is investigated on #74690. Generated-by: Claude Opus 5 (cherry picked from commit 40b5d36) One adaptation: #75439 rewrote the "Stopping when Airflow asks" section of java.rst, so the section is removed in that rewritten form rather than the one the original revert deletes. java.rst now matches main. Co-authored-by: Jarek Potiuk <jarek@potiuk.com> Co-authored-by: Claude <noreply@anthropic.com>
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
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.
Backport of #74701 to
v3-4-test. The automatic backport failed to cherry-pick it (run details), so it is picked by hand from a419633.One adaptation, since
v3-4-testandmaindiffer here:v3-4-testkeeps the signal-awareContext(#74690, backported in #75386) because the revert onmain(#75421) was not backported, so this keeps the "Stopping when Airflow asks" section that themainversion of the rewrite no longer has. Everything else matches the original commit.Was generative AI tooling used to co-author this PR?