1. I still suggest to use the tag `<i>` for attribute references like all the
other functions do. The tag `<code>` has different styles in different code
environments (e.g., lines enclosed with `{% highlight XXX %}`).
2. The SQL doc convention was sourced from Calcite
(https://calcite.apache.org/docs/reference.html#operators-and-functions) and
when I reworked this page, the convention was reserved.
3. I also agree that the return type is important to users. However, before
reaching a consensus about the format and the internal implementation, I
suggest to keep the current doc style, i.e., without mentioning the return
type, for now.
[ Full content available at: https://github.com/apache/flink/pull/6700 ]
This message was relayed via gitbox.apache.org for [email protected]
