start writing readme

1 files changed, 51 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..52dab70
--- /dev/null
+++ b/README.md
@@ -0,0 +1,51 @@
+# Datagengo
+
+Datagengo (データ言語) is a new (experimental) method for learning japanese kanji.
+
+Datagengo is an algorimically-generated list of lessons, each containing a batch of 20 kanji and just enough example sentences to learn those kanji in context.
+The crux of the method consists in memorizing a set of sentences that make use of these kanji and writing them down repeatedly on paper.
+
+Lessons are in increasing difficulty according to JLPT levels and school grade indicated in [KANJIDIC2](http://www.edrdg.org/wiki/index.php/KANJIDIC_Project)
+(the JLPT levels used are the old levels N4-N1 and not the new levels, see [this document](https://jlpt.jp/e/reference/pdf/guide2011_e_02.pdf) for correspondence).
+Example sentences are sourced from the [Tanaka corpus](http://www.edrdg.org/wiki/index.php/Tanaka_Corpus).
+
+## How to study a lesson
+
+**High-level overview:**
+
+1. Write down the 20 kanji for each lesson.
+2. Write down all of the example sentences in the lesson from memory.
+3. Check what you did.
+4. Rinse and repeat.
+
+**Detailed explanation:**
+
+1. Write down the number of the lesson, the current date and time, and how many times you have studied this lesson (including this time).
+
+2. Write down the 20 kanji composing the lesson.
+   If possible, do this from memory, otherwise it's fine to look at the lesson page.
+   Make sure that you are not mixing up different kanji and that you know the correct stroke order for each kanji.
+
+3. If this is your first encounter with this lesson, just read the sentences and familiarize yourself with all of the sentences and the new words they contain, and be done with it.
+   Otherwise, proceed to the next step.
+
+4. If this is one of the first few times you are studying this lesson, re-read all of the sentences to ensure you have them in mind.
+
+5. Close the lesson's web page, and write down all of the sentences in the lesson from memory.
+   You can use the list of 20 kanji you just wrote to help you remember the sentences.
+
+6. Return to the lesson's web page and check that you wrote all sentences correctly.
+   If you have any doubts on stroke order or pronunciation, take the time to check.
+
+7. Write down the time at which you finished studying the lesson.
+
+8. If you have the patience, have a look at the "extra vocabulary" section at the bottom of the lesson's page.
+   You don't need to actively memorize this, it's just so that you have the information that these words can be written using the kanji of this lesson when you encounter them elsewhere.
+
+The overall process takes 10 to 15 minutes per lesson, sometimes less, sometimes more. Each lesson will take less and less time as you repeat it.
+
+## Planning your study
+
+
+
+## Why this method?