From e51928603de89c0aa5267e925112701ad4832cdb Mon Sep 17 00:00:00 2001
From: Laurens Valk <laurens@pybricks.com>
Date: Sun, 20 Sep 2020 00:06:50 +0200
Subject: [PATCH] README: Initial introduction.

---
 README.md        | 20 ++++++++++++++++++--
 lsynth/README.md |  0
 2 files changed, 18 insertions(+), 2 deletions(-)
 create mode 100644 lsynth/README.md

diff --git a/README.md b/README.md
index 0de8e0f00..e2c96415d 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,18 @@
-# ldraw
-ldraw library and tools with version control
+# LDraw
+
+This is a mirror of the LDraw LEGO parts library available at [ldraw.org](https://www.ldraw.org/). It is the same collection of parts, but with all the benefits of version control. See also the original LDraw [Readme.txt](Readme.txt).
+
+### Usage
+
+```
+git clone https://github.com/pybricks/ldraw.git
+```
+
+This creates the `ldraw` folder. Use it like you always do.
+
+
+### Changes compared to the official `complete.zip` parts pack:
+- Full Git history since the 2008 re-release.
+- Fixed [`mklist`](./mklist) source code. The `exe` files are unchanged.
+- Includes [`lsynth`](./lsynth) source code and dependencies.
+
diff --git a/lsynth/README.md b/lsynth/README.md
new file mode 100644
index 000000000..e69de29bb