Github user ChrisChinchilla commented on the issue:
https://github.com/apache/flink/pull/5045
@greghogan @zentol I will get these updates to you asap.
But I will have to strongly disagree on the 'you' and passive voice points.
I've been working as a technical writer for some time, and this a point we're
all fairly strong on pushing as in the long run it does make documents much
clearer, less ambiguous and easier to read.
Granted a LOT of the Flink documentation doesn't follow this style right
now, and that's something I personally would love to change over time, as I
really think it would help people understand better.
Ideally I would love to create a more comprehensive style guide and
explanation of this (and I have boilerplates I've used with other projects) and
change this voicing over time.
Thoughts?
---
