RFR: Updates to the JBS section of the OpenJDK Dev Guide [v7]
calnan
duke at openjdk.org
Fri May 12 20:25:11 UTC 2023
On Tue, 9 May 2023 16:38:31 GMT, Iris Clark <iris at openjdk.org> wrote:
>> src/guide/jbs-jdk-bug-system.md line 78:
>>
>>> 76: * If the failure isn't reproducible with an existing OpenJDK test, attach a reproducer if possible, while in a number of cases it isn't possible, having a test case will decrease the time required to resolve the issue.
>>> 77: * Only set [CPU]{.jbs-field} and/or [OS]{.jbs-field} fields if the bug **ONLY** happens on that particular platform or set of platforms.
>>> 78: * Including the java -fullversion is encouraged for bugs in the JVM, hangs, network issues where the exact version can be critical to determine what fixes may be missing from an older version.
>>
>> This sentence doesn't read well and I'm not sure what point it is trying to make. `java -version` is what is needed and that is a superset of `java -fullversion`.
>
> Something like: "Provide the output of `java -version ` whenever possible. This version information is particularly critical for hangs, JVM bugs, and network issues."
updated
-------------
PR Review Comment: https://git.openjdk.org/guide/pull/100#discussion_r1192763013
More information about the guide-dev
mailing list