[GitHub] [beam] kennknowles opened a new issue, #18063: Javadoc should clearly separate facts from runner requirements

[GitBox <gi...@apache.org>]

kennknowles opened a new issue, #18063:
URL: https://github.com/apache/beam/issues/18063

   The javadoc for View.asMap() says the map needs to fit in memory. That's not true in all runners. (For example, Dataflow has distributed map support.) 
   
   https://github.com/apache/incubator-beam/blob/master/sdks/java/core/src/main/java/org/apache/beam/sdk/transforms/View.java
   
   This is likely just one specific case of a more general issue \-- different runners will have common constraints on the scalability of portions of the model. Currently these are documented in the capability matrix on the website, but for usability we should consider surfacing these constraints on particularly relevant methods. But keeping things in sync in multiple locations is hard...
   
   Imported from Jira [BEAM-728](https://issues.apache.org/jira/browse/BEAM-728). Original Jira may contain additional context.
   Reported by: frances.


-- 
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: github-unsubscribe@beam.apache.org.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org