beam-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "ASF GitHub Bot (JIRA)" <>
Subject [jira] [Commented] (BEAM-1695) Improve Python-SDK's programming guide
Date Thu, 27 Apr 2017 13:06:04 GMT


ASF GitHub Bot commented on BEAM-1695:

GitHub user tibkiss opened a pull request:

    [BEAM-1695] Improve Python-SDK's programming guide

    Be sure to do all of the following to help us incorporate your contribution
    quickly and easily:
     - [ ] Make sure the PR title is formatted like:
       `[BEAM-<Jira issue #>] Description of pull request`
     - [ ] Make sure tests pass via `mvn clean verify`. (Even better, enable
           Travis-CI on your fork and ensure the whole test matrix passes).
     - [ ] Replace `<Jira issue #>` in the title with the actual Jira issue
           number, if there is one.
     - [ ] If this contribution is large, please file an Apache
           [Individual Contributor License Agreement](

You can merge this pull request into a Git repository by running:

    $ git pull BEAM-1695

Alternatively you can review and apply these changes as the patch at:

To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:

    This closes #2738
commit 60e3772ce91f79dbc5dc5cef375dd95976b93172
Author: Tibor Kiss <>
Date:   2017-04-27T12:12:13Z

    [BEAM-1695] Improve Python-SDK's programming guide


> Improve Python-SDK's programming guide
> --------------------------------------
>                 Key: BEAM-1695
>                 URL:
>             Project: Beam
>          Issue Type: Bug
>          Components: website
>            Reporter: Tibor Kiss
>            Assignee: Tibor Kiss
>            Priority: Minor
>              Labels: newbie, starter
> Beam's programming guide provides a tutorial-like structure to introduce the user to
the main concepts.
> Due to flaws of the snippets the copied code needs altering to work.
> Some of the problems:
> * Section "Creating the pipeline"
> ** {{import apache_beam as beam}} statement is missing from the beginning
> ** The command line arguments are not parsed
> * Section "Creating a PCollection from in-memory data"
> ** {{pipeline_options}} variable is undefined
> ** {{my_options}} variable is undefined
> * Section "ParDo": 
> ** It is not explained how to define {{words}} variable
> * Section "Advanced combinations using CombineFn" and "Combining a PCollection into a
single value" has the same code snippet
> * Section "Combining values in a key-grouped collection":
> ** -It is not explained how to define {{player_accuracies}}-
> * Section "Using Flatten and Partition"
> ** The code snippet contains unnecessary markers ({{[START model_multiple_pcollections_tuple]}})
> * Section "partition":
> ** {{students}} variable is undefined
> This list might not be complete.
> The website's repo is located at:
> The snippets are taken from:

This message was sent by Atlassian JIRA

View raw message