Github user zentol commented on the issue:
https://github.com/apache/flink/pull/5822
Annotations have a number of advantages:
* they don't pollute the `ConfigOption` class with documentation concerns
* we don't have to define reasonable defaults to prevent issues at runtime
* we can add/remove annotations at any time as they aren't `@Public`---
