From c3e11b7955754a53fc4bb5e6b671a50996e5628b Mon Sep 17 00:00:00 2001
From: Zdenek Zambersky <zzambers@redhat.com>
Date: Wed, 15 Nov 2023 16:20:27 +0100
Subject: [PATCH] Backport 4fbe635b21e3aba14dba760168a2f8965c7b29f5

---
 README    | 10 ----------
 README.md | 11 +++++++++++
 2 files changed, 11 insertions(+), 10 deletions(-)
 delete mode 100644 README
 create mode 100644 README.md

diff --git a/README b/README
deleted file mode 100644
index c93292bfbe4..00000000000
--- a/README
+++ /dev/null
@@ -1,10 +0,0 @@
-Welcome to OpenJDK!
-===================
-
-For information about building OpenJDK, including how to fully retrieve all
-source code, please see either of these:
-
-  * doc/building.html   (html version)
-  * doc/building.md     (markdown version)
-
-See http://openjdk.java.net/ for more information about OpenJDK.
diff --git a/README.md b/README.md
new file mode 100644
index 00000000000..399e7cc311f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+# Welcome to the JDK!
+
+For build instructions please see the
+[online documentation](https://openjdk.java.net/groups/build/doc/building.html),
+or either of these files:
+
+- [doc/building.html](doc/building.html) (html version)
+- [doc/building.md](doc/building.md) (markdown version)
+
+See <https://openjdk.java.net/> for more information about
+the OpenJDK Community and the JDK.