[jfx17] RFR: 8250590: Classes and methods in the javafx.css package are missing documentation [v3]

[Kevin Rushforth]

On Wed, 28 Jul 2021 13:08:28 GMT, Pankaj Bansal <pbansal at openjdk.org> wrote:

> I am surprised that this does not need a CSR. It looks like too much bigger documentation change for not needing a CSR.

JavaFX doesn't impose the same requirement of needing a CSR for everything that touches API documentation as does the JDK. In this case, it is just adding obvious and missing API docs without any changes in documented behavior or any additional conditions in the specification. While it wouldn't hurt to have a CSR, I'm not sure I see the need.

Btw, the number of lines of documentation added isn't really the question. A one-line change can end up needing a CSR if there are changes to the specified semantics.

-------------

PR: https://git.openjdk.java.net/jfx/pull/589