RFC: 8247976: Update HotSpot Style Guide for C++14 adoption

[Kim Barrett]

> On Jun 23, 2020, at 3:32 PM, Kim Barrett <kim.barrett at oracle.com> wrote:
> 
> Please review / comment on this proposed update to the HotSpot Style
> Guide. This is part of the work for JDK-8208089: JEP 347: Adopt C++14
> Language Features in the JDK.
> 
> […]  Once
> reviewed, the finished text can be used to update the wiki, unless we
> decide it should be homed somewhere else.

There has recently been a lot of discussion about where this and
somewhat similar documents should reside.  Most of that has been about
a Java Style Guide, which has somewhat different issues than this one.
(The HotSpot Style Guide is very focused in scope, and is unlikely to
have much, if any, influence on usage by the wider C++ community.)

Proposed homes include:

- Remain in the OpenJDK wiki.
- Use an informational JEP.
- Move to the new Developer's Guide.
- Move to the JDK repository.

For some of the discussion, see comments in JDK-8208089, as well as
the recent thread on the jdk-dev mailing list:
https://mail.openjdk.java.net/pipermail/jdk-dev/2020-June/004443.html
https://mail.openjdk.java.net/pipermail/jdk-dev/2020-July/004461.html

Based on that discussion, I'm planning to move it to the JDK
repository, in jdk/jdk/doc. That is already a place for
developer-focused documentation; it's the home of building.{md,html},
testing.{md,html}, and ide.{md,html}. I think this style guide fits
well with that collection.

I think the other two wiki pages associated with the current wiki
HotSpot Style Guide would similarly fit well there, and I suggest we
move them as well.

Comments?