From 772d94591312703a7e2877a34ac3b740033f326b Mon Sep 17 00:00:00 2001
From: nojhan <nojhan@nojhan.net>
Date: Sun, 3 Aug 2025 23:54:32 +0200
Subject: [PATCH] better README

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

diff --git a/README b/README
deleted file mode 100644
index ad4fb52..0000000
--- a/README
+++ /dev/null
@@ -1,3 +0,0 @@
-Set of Hanafuda cards in the form of 12 pictures in the SVG format.
-
-Run `make` to export the large pictures and the cards in PNG files.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e6de053
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+# nojhan's Hanafuda cards set and almanac
+
+This is a set of 12 vector pictures, one for each month of the year,
+in the SVG format.
+Each picture contains details that can be exported
+as a set of Hanafuda cards.
+
+
+## Create the cards and the almanac
+
+You need to have [imagemagick](https://imagemagick.org/)
+and [inkscape](https://www.inkscape.org) installed on your computer.
+
+Run `make` to export the main pictures, each cards,
+all pictures in one image, and all cards in one image.
+