[
https://issues.apache.org/jira/browse/BEAM-10480?focusedWorklogId=515746&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-515746
]
ASF GitHub Bot logged work on BEAM-10480:
-----------------------------------------
Author: ASF GitHub Bot
Created on: 23/Nov/20 20:04
Start Date: 23/Nov/20 20:04
Worklog Time Spent: 10m
Work Description: boyuanzz commented on a change in pull request #13227:
URL: https://github.com/apache/beam/pull/13227#discussion_r528964281
##########
File path:
website/www/site/content/en/documentation/io/developing-io-overview.md
##########
@@ -46,33 +46,32 @@ are the recommended steps to get started:
For **bounded (batch) sources**, there are currently two options for creating a
Beam source:
+1. Use `Splittable DoFn`.
+
1. Use `ParDo` and `GroupByKey`.
-1. Use the `Source` interface and extend the `BoundedSource` abstract subclass.
-`ParDo` is the recommended option, as implementing a `Source` can be tricky.
See
-[When to use the Source interface](#when-to-use-source) for a list of some use
-cases where you might want to use a `Source` (such as
-[dynamic work rebalancing](/blog/2016/05/18/splitAtFraction-method.html)).
+`Splittable DoFn` is the recommended option, as it's the new source framework
for both bounded and
Review comment:
`Most recent` sounds good. I'm curious why `new` is not perferred?
----------------------------------------------------------------
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: 515746)
Time Spent: 3h 10m (was: 3h)
> Revisit and clean up SDF documentations after feature completed.
> ----------------------------------------------------------------
>
> Key: BEAM-10480
> URL: https://issues.apache.org/jira/browse/BEAM-10480
> Project: Beam
> Issue Type: Improvement
> Components: sdk-java-core, sdk-py-core
> Reporter: Boyuan Zhang
> Priority: P3
> Labels: Clarified
> Time Spent: 3h 10m
> Remaining Estimate: 0h
>
> We want to revisit and improve javadoc and python documentation for SDF APIs.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
