[
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)