[ 
https://issues.apache.org/jira/browse/BEAM-13011?focusedWorklogId=718903&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-718903
 ]

ASF GitHub Bot logged work on BEAM-13011:
-----------------------------------------

                Author: ASF GitHub Bot
            Created on: 01/Feb/22 19:14
            Start Date: 01/Feb/22 19:14
    Worklog Time Spent: 10m 
      Work Description: pcoet commented on a change in pull request #16649:
URL: https://github.com/apache/beam/pull/16649#discussion_r796916704



##########
File path: website/www/site/content/en/documentation/programming-guide.md
##########
@@ -7046,3 +7046,7 @@ When an SDK-specific wrapper isn't available, you will 
have to access the cross-
 Currently, portable runners such as Flink, Spark, and the direct runner can be 
used with multi-language pipelines.
 
 Dataflow supports multi-language pipelines through the Dataflow Runner v2 
backend architecture.
+
+### 13.4 Tips and Troubleshooting
+
+For tips related to multi-language pipelines and troubleshooting information, 
please see 
[here](https://cwiki.apache.org/confluence/display/BEAM/Multi-language+Pipelines+Tips).

Review comment:
       Consider: "For additional tips and troubleshooting information, see 
[Multi-language Pipelines 
Tips](https://cwiki.apache.org/confluence/display/BEAM/Multi-language+Pipelines+Tips)




-- 
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]


Issue Time Tracking
-------------------

            Worklog Id:     (was: 718903)
    Remaining Estimate: 0h
            Time Spent: 10m

> Improve xlang docs
> ------------------
>
>                 Key: BEAM-13011
>                 URL: https://issues.apache.org/jira/browse/BEAM-13011
>             Project: Beam
>          Issue Type: Improvement
>          Components: cross-language, website
>            Reporter: Reza ardeshir rokni
>            Assignee: David Huntsperger
>            Priority: P2
>              Labels: stale-P2
>             Fix For: Not applicable
>
>          Time Spent: 10m
>  Remaining Estimate: 0h
>
> The documentation for xlang components is a mix of tutorial, guide and how to 
> which is very difficult to follow, especially if coming to Xlang for the 
> first time.
> [http://beam.apache.org/documentation/programming-guide/#multi-language-pipelines|https://www.google.com/url?q=http://beam.apache.org/documentation/programming-guide/%23multi-language-pipelines&sa=D&usg=AOvVaw0EhoMT9ttwomsjsIY6dUDT]
> I would recommend:
> 1-
>  That  talk from Beam summit :
> [https://www.youtube.com/watch?v=bt5DMP9Cwz0]
>  Be replicated within the docs, including the rpc calls between the expansion 
> service and other components that he references in the talk.
> 2-
>  Separate out the guide material from tutorial as two different pieces
> 3-
>  Provide a Hello world Python in Java and Java in Python example which 
> includes full working commands.
> 5-
>  We reference classes in :
>  
> [https://github.com/apache/beam/blob/master/sdks/python/apache_beam/transforms/external.py|https://www.google.com/url?q=https://github.com/apache/beam/blob/master/sdks/python/apache_beam/transforms/external.py&sa=D&usg=AOvVaw2G3MS4kKmMPRlCL8-wg4Rg]
> But we dont really say how those classes should be run, this should also be 
> part of the tutorial.



--
This message was sent by Atlassian Jira
(v8.20.1#820001)

Reply via email to