uranusjr commented on code in PR #71151:
URL: https://github.com/apache/airflow/pull/71151#discussion_r3794131383
##########
contributing-docs/30_new_language_sdk.rst:
##########
@@ -491,6 +496,32 @@ native Dags they are *not applicable* (``n/a``) rather
than unsupported.
The SDK exposes an object-storage API (an ``ObjectStoragePath``
equivalent) usable from
native Dag code.
+Compatibility matrix
+~~~~~~~~~~~~~~~~~~~~
+
+The dimensions above are prose; each SDK also declares them *machine-readably*
in one
+hand-authored ``<sdk>/capabilities.yaml``, from which a prek hook generates
every table:
+
+.. code-block:: text
+
+ java-sdk/capabilities.yaml <- the only file you edit
+ |
+ | hook: update-java-sdk-readme-matrix
+ |
+ +--> 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 — TODO, not generated yet)
Review Comment:
Do we track this somewhere? It’s better to reference the issue directly here
instead of just a plain text TODO.
--
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]
