RFR: Updates to the JBS section of the OpenJDK Dev Guide [v7]

[calnan]

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