Flesh out READMEHEADdev

Change-Id: I58d5e82c0fd04764d1bfb9bd068810b3d1a3790c
Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io>
Reviewed-by: Oliver Wolff <oliver.wolff@qt.io>

2 files changed, 33 insertions, 1 deletions

diff --git a/README b/README
deleted file mode 100644
index 0909b2b..0000000
--- a/README
+++ /dev/null
@@ -1 +0,0 @@
-The QtMacExtras module no longer exists in Qt 6 (see QTBUG-93629).
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..93fc44a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,33 @@
+# QtMacExtras
+
+**The QtMacExtras module has been deprecated and is no longer part of Qt.**
+
+The functionality of the module has been incorporated into other parts of Qt, or in some cases
+removed due to being obsolete or better suited as cross platform APIs.
+
+For more details, see [QTBUG-93629](https://bugreports.qt.io/browse/QTBUG-93629) in the Qt issue
+tracker.
+
+## Porting away from QtMacExtras
+
+To learn more about how to port from QtMacExtras to alternative APIs please visit the
+[Qt 6 porting guide](https://doc.qt.io/qt-6/portingguide.html).
+
+## Working on Qt 5
+
+To work on patches for the Qt 5 series, check out a local branch of the relevant Qt version, e.g.:
+
+```bash
+$ git checkout 5.15
+Branch '5.15' set up to track remote branch '5.15' from 'origin' by rebasing.
+Switched to a new branch '5.15'
+```
+
+## Going back in time
+
+To inspect the code in the `dev` branch prior to its removal, follow these steps:
+
+```bash
+$ git checkout -b my-dev 1af4a00d7
+Switched to a new branch 'my-dev'
+```