RFR: Updated section on Code Conventions. [v3]

[Andreas Lundblad]

On Thu, 25 Jun 2020 03:57:11 GMT, Jesper Wilhelmsson <jwilhelm at openjdk.org> wrote:

>> Andreas Lundblad has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Moved introductory text to code conventions page.
>
> src/javaStyleGuide.md line 1075:
> 
>> 1074: ### Javadoc
>> 1075: This section only covers basic Javadoc formatting. For a complete reference refer to  [How to Write Doc
>> Comments for the Javadoc Tool](http://www.oracle.com/technetwork/articles/java/index-137868.html). 1076:
> 
> Since Javadoc is slightly out of scope, and there is a complete reference for it, can we move it down to where comments
> are handled and give it a less prominent placement there?

Good suggestion. Updated.

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

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