pskevin commented on a change in pull request #12071:
URL: https://github.com/apache/beam/pull/12071#discussion_r459124896
##########
File path:
runners/core-construction-java/src/test/java/org/apache/beam/runners/core/construction/ValidateRunnerXlangTest.java
##########
@@ -54,15 +60,36 @@
import org.junit.runner.RunWith;
import org.junit.runners.JUnit4;
-/** Test External transforms. */
+/**
+ * Runner Validation Test Suite for Cross-language Transforms.
+ *
+ * <p>As per Beams's Portability Framework design, Cross-language transforms
should work out of the
+ * box. In spite of this, there always exists a possibility of rough edges
existing. It could be
+ * caused due to unpolished implementation of any part of the execution code
path, for example:
+ *
+ * <ul>
+ * <li>Transform expansion [SDK]
+ * <li>Pipeline construction [SDK]
+ * <li>Cross-language artifact staging [Runner]
+ * <li>Language specific serialization/deserialization of PCollection (and
other data types)
+ * [Runner/SDK]
+ * </ul>
+ *
+ * <p>In an effort to improve developer visibility into potential problems,
this test suite
+ * validates a cross-language runner against <i>5 Core Beam transforms</i>
from any foreign language
Review comment:
Acknowledged and reflected in the latest changes!
----------------------------------------------------------------
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.
For queries about this service, please contact Infrastructure at:
[email protected]
