flink-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Aljoscha Krettek <aljos...@apache.org>
Subject Re: Object reuse documentation should be improved
Date Mon, 14 Dec 2015 10:33:19 GMT
Good write up. You could extend the Table of 1) a/b 2) a/b at the top with “chaining” (but
you already know this, I guess). Chaining changes all of these and I think it can be tricky
to know whether stuff is chained or not (for users, and even for us developers…).


> On 13 Dec 2015, at 19:24, Gábor Gévay <ggab90@gmail.com> wrote:
> 
> Hello,
> 
> I find the documentation about object reuse [1] very confusing. I
> started a Google Doc [2] about clarifying/rewriting it.
> 
> First, it states four questions that I think should have answers
> stated explicitly in the documentation, and then lists some concrete
> problems (ambiguities) in the current text.
> 
> [1] https://ci.apache.org/projects/flink/flink-docs-master/apis/programming_guide.html#object-reuse-behavior
> [2] https://docs.google.com/document/d/1cgkuttvmj4jUonG7E2RdFVjKlfQDm_hE6gvFcgAfzXg/edit?usp=sharing
> 
> Best,
> Gabor


Mime
View raw message