uranusjr commented on code in PR #71757:
URL: https://github.com/apache/airflow/pull/71757#discussion_r4336138278
##########
contributing-docs/30_new_language_sdk.rst:
##########
@@ -524,11 +559,27 @@ hand-authored ``<sdk>/capabilities.yaml``, from which a
prek hook generates its
|
+--> java-sdk/README.md (contributor-facing)
+--> java-sdk/sdk/module.md (Dokka -> the published API reference)
+ +--> airflow-core/docs/authoring-and-scheduling/language-sdks/index.rst
+ (consolidated cross-SDK matrix)
-The hook rewrites its targets and exits non-zero when either was stale, so a
drifted table fails
+Each hook rewrites its targets and exits non-zero when a target was stale, so
a drifted table fails
the build. Keep the manifest out of whatever the SDK publishes — it describes
the SDK rather than
being part of it; for Java that means sitting above every subproject in
``settings.gradle.kts``.
+A supported dimension may also record ``sdk_version``, the SDK's own release
that shipped it,
+alongside ``since`` (the Airflow version). It's optional; omit it when no SDK
release has been
+tagged yet. A shared capability holds one entry per authoring mode:
Review Comment:
```suggestion
A supported dimension may also record ``sdk_version``, the SDK's own release
that shipped it,
alongside ``since`` (the Airflow version). It's optional; the SDK release
that ships
(or will ship) it. A shared capability holds one entry per authoring mode:
```
--
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: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
