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

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

                Author: ASF GitHub Bot
            Created on: 12/Mar/20 15:51
            Start Date: 12/Mar/20 15:51
    Worklog Time Spent: 10m 
      Work Description: soyrice commented on issue #11075: [BEAM-9421] Website 
section that describes getting predictions using AI Platform Prediciton
URL: https://github.com/apache/beam/pull/11075#issuecomment-598263989
 
 
   This looks great. I can give it an editorial pass, but I'll wait until we 
have a plan to move forward re: tfx_bsl.
   
   In the meantime, here are a couple suggestions for improving the write-up:
   - Avoid "we" pronouns wherever possible (same for "let's"). Many of these 
sentences can be rewritten without pronouns. For instance, "you have to make" 
can be simplified to just "make."
   - If a pronoun is necessary, use the second person "you" to talk directly to 
the reader.
   - Try to keep the opening paragraphs as short and succinct as possible. 
Consider breaking up long paragraphs into multiple, smaller ones. This makes it 
easier for readers to scan the doc.
   - Introduce the code sample by explaining what it does, rather than 
explaining afterwards.
   
   I put together a [checklist/template for Beam 
patterns](https://docs.google.com/document/d/1lawWkFPDYV9ORUZbLZUxTvjG6hunyxDdR4s3tvQi6G4/edit)
 if you want to take a look. The PR already looks good from a content 
perspective, so this is just for reference :)
 
----------------------------------------------------------------
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]


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

    Worklog Id:     (was: 402272)
    Time Spent: 1h 10m  (was: 1h)

> AI Platform pipeline patterns
> -----------------------------
>
>                 Key: BEAM-9421
>                 URL: https://issues.apache.org/jira/browse/BEAM-9421
>             Project: Beam
>          Issue Type: Sub-task
>          Components: website
>            Reporter: Kamil Wasilewski
>            Assignee: Kamil Wasilewski
>            Priority: Major
>              Labels: pipeline-patterns
>          Time Spent: 1h 10m
>  Remaining Estimate: 0h
>
> New pipeline patterns should be contributed to the Beam's website in order to 
> demonstrate how newly implemented Google Cloud AI PTransforms can be used in 
> pipelines.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

Reply via email to