From 76dbbdd6658544c02edc944e7d941949c0a3d6af Mon Sep 17 00:00:00 2001
From: icex2 <djh.icex2@gmail.com>
Date: Sat, 10 Apr 2021 15:04:28 +0200
Subject: [PATCH] Overhaul root readme

Provide a more user/developer-friendly entry point to the project
---
 README.md | 66 +++++++++++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 57 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index bdbbf34..729c4e6 100644
--- a/README.md
+++ b/README.md
@@ -1,16 +1,64 @@
 # Segatools
 
-Quick start on a Linux build host:
+Version: `v005`
 
-```
-# Install Meson and a recent build of MinGW-w64, then:
+Loaders and hardware emulators for SEGA games that run on the Nu and ALLS platforms.
 
-$ meson --cross cross-mingw-32.txt _build32
-$ ninja -C _build32
-$ meson --cross cross-mingw-64.txt _build64
-$ ninja -C _build64
+## List of supported games
+
+* Chunithm
+  * [Chunithm (Plus)](doc/chunihook.md)
+  * [Chunithm Air (Plus)](doc/chunihook.md)
+  * [Chunithm Star (Plus)](doc/chunihook.md)
+  * [Chunithm Amazon (Plus)](doc/chunihook.md)
+  * [Chunithm Crystal (Plus)](doc/chunihook.md)
+* Initial D
+  * Initial D Zero
+
+## End-users
+
+For setup and configuration guides, refer to the dedicated documents available for each game, see
+[the links in the previous section](#list-of-supported-games).
+
+## Developers
+
+### Building
+
+The root `Makefile` contains various targets that allow you to build the project easily.
+
+#### Local build
+
+For a local build, you need to install Meson and a recent build of MinGW-w64. Then you can start the
+build process:
+
+```shell
+make build
 ```
 
-Building on MSYS2 is also possible; consult Meson documentation for details.
+Build output will be located in `build/build32` and `build/build64` folders.
 
-Additional documentation will be forthcoming.
+#### Cleanup local build
+
+```shell
+make clean
+```
+
+#### Create distribution package (zip file)
+
+```shell
+make dist
+```
+
+The output will be located in `build/zip`.
+
+#### Build and create distribution package using docker
+
+You can also build using docker which avoids having to setup a full development environment if you
+are just interested in building binaries of the latest changes. Naturally, this requires you to
+have the docker daemon installed.
+
+```shell
+make build-docker
+```
+
+Once completed successfully, the build output is located in the `build/docker/zip` sub-folder.