diff --git a/docs/README-git.md b/docs/README-git.md
new file mode 100644
index 000000000..3f03488ae
--- /dev/null
+++ b/docs/README-git.md
@@ -0,0 +1,19 @@
+git
+=========
+
+The latest development version of SDL is available via git.
+Git allows you to get up-to-the-minute fixes and enhancements;
+as a developer works on a source tree, you can use "git" to mirror that
+source tree instead of waiting for an official release. Please look
+at the Git website ( https://git-scm.com/ ) for more
+information on using git, where you can also download software for
+macOS, Windows, and Unix systems.
+
+    git clone https://github.com/libsdl-org/SDL
+
+If you are building SDL via configure, you will need to run autogen.sh
+before running configure.
+
+There is a web interface to the Git repository at:
+	http://github.com/libsdl-org/SDL/
+
diff --git a/docs/README-hg.md b/docs/README-hg.md
new file mode 100644
index 000000000..b42aaa5b2
--- /dev/null
+++ b/docs/README-hg.md
@@ -0,0 +1,7 @@
+Mercurial
+======
+
+We are no longer hosted in Mercurial. Please see README-git.md for details.
+
+Thanks!
+