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

[Iris Clark]

On Tue, 21 Mar 2023 04:55:40 GMT, David Holmes <dholmes at openjdk.org> wrote:

>> calnan has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Updates to address current round of feedback
>
> 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."

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

PR Review Comment: https://git.openjdk.org/guide/pull/100#discussion_r1188866239