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