8251551: Use .md filename extension for README

[zzambers]

This backport adds .md extension to README. It also changes formulations a bit and adds some hyperlinks. Backport is not clean because there were small intermediate changes to README by (changesets not applicable to JDK8):

• JDK-8187444
• JDK-8205956

(Git however considers this rewrite anyway.)

---

Progress

• Change must be properly reviewed (1 review required, with at least 1 Reviewer)
• Change must not contain extraneous whitespace
• Commit message must refer to an issue
• JDK-8251551 needs maintainer approval

Issue

• JDK-8251551: Use .md filename extension for README (Enhancement - P4 - Approved)

Reviewers

• Paul Hohensee (@phohensee - Reviewer)

Reviewing

Using git

Checkout this PR locally:
$ git fetch https://git.openjdk.org/jdk8u-dev.git pull/394/head:pull/394
$ git checkout pull/394

Update a local copy of the PR:
$ git checkout pull/394
$ git pull https://git.openjdk.org/jdk8u-dev.git pull/394/head

Using Skara CLI tools

Checkout this PR locally:
$ git pr checkout 394

View PR using the GUI difftool:
$ git pr show -t 394

Using diff file

Download this PR as a diff file:
https://git.openjdk.org/jdk8u-dev/pull/394.diff

Webrev

Link to Webrev Comment

[bridgekeeper]

👋 Welcome back zzambers! A progress list of the required criteria for merging this PR into master will be added to the body of your pull request. There are additional pull request commands available for use with this pull request.

[openjdk]

This backport pull request has now been updated with issue from the original commit.

[mlbridge]

Webrevs

• 00: Full (c3e11b79)

[phohensee]

Looks like a clean backport from 11u. GHA test failure appears unrelated (this PR doesn't affect GC).

[openjdk]

⚠️ @zzambers This change is now ready for you to apply for maintainer approval. This can be done directly in each associated issue or by using the /approval command.

[zzambers]

/approval request Use .md filename extension for README, only updates README

[openjdk]

@zzambers
8251551: The approval request has been created successfully.

[openjdk]

@zzambers This change now passes all automated pre-integration checks.

After integration, the commit message for the final commit will be:

8251551: Use .md filename extension for README

Reviewed-by: phh

You can use pull request commands such as /summary, /contributor and /issue to adjust it as needed.

At the time when this comment was updated there had been 4 new commits pushed to the master branch:

• b2655a7: 8297955: LDAP CertStore should use LdapName and not String for DNs
• 3b9c787: 8208655: use JTreg skipped status in hotspot tests
• 0464401: 8320713: Bump update version of OpenJDK: 8u412
• b372b4b: 8312489: Increase jdk.jar.maxSignatureFileSize default which is too low for JARs such as WhiteSource/Mend unified agent jar

Please see this link for an up-to-date comparison between the source branch of this pull request and the master branch.
As there are no conflicts, your changes will automatically be rebased on top of these commits when integrating. If you prefer to avoid this automatic rebasing, please check the documentation for the /integrate command for further details.

➡️ To integrate this PR with the above commit message to the master branch, type /integrate in a new comment.

[zzambers]

thanks
/integrate

[openjdk]

Going to push as commit 2f81fb4.
Since your change was applied there have been 4 commits pushed to the master branch:

• b2655a7: 8297955: LDAP CertStore should use LdapName and not String for DNs
• 3b9c787: 8208655: use JTreg skipped status in hotspot tests
• 0464401: 8320713: Bump update version of OpenJDK: 8u412
• b372b4b: 8312489: Increase jdk.jar.maxSignatureFileSize default which is too low for JARs such as WhiteSource/Mend unified agent jar

Your commit was automatically rebased without conflicts.

[openjdk]

@zzambers Pushed as commit 2f81fb4.

💡 You may see a message that your pull request was closed with unmerged commits. This can be safely ignored.