RFR: Updated section on Code Conventions.

[Andreas Lundblad]

On Mon, 1 Jun 2020 01:05:48 GMT, Jesper Wilhelmsson <jwilhelm at openjdk.org> wrote:

>> Pull request for adding code conventions.
>> 
>> The code conventions in this pull request is a verbatim copy of [3]. These conventions were the ones discussed in
>> detail on discuss at openjdk.java.net in 2015. Two rounds of reviews were performed, [1] [2], and all comments were
>> addressed. The 6th and last draft [3] has been stable since then, and been in use by several OpenJDK projects.  [1]
>> http://mail.openjdk.java.net/pipermail/discuss/2015-August/003766.html [2]
>> http://mail.openjdk.java.net/pipermail/discuss/2015-August/003771.html [3]
>> http://cr.openjdk.java.net/~alundblad/styleguide/index-v6.html
>
> Thank you for contributing this style guide. This is something that many have been asking about.

> If we have agreed policies about coding style then we should treat them as authoritative, normative information. As
> such, they'd be out of place in a Guide that's meant only to contain tutorials and suggestions.

Sounds like a very narrow definition of a dev guide. This content is usually even referred to as a style _guide_.

In my head, it's very much in line with the section on _Producing a Changeset_. I imagine the target audience is pretty
much the same too.

That being said, where would you suggest publishing style guides?

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

PR: https://git.openjdk.java.net/guide/pull/14