diff --git a/README.md b/README.md
index e74f3cbea084e1f03032a21c151c9fecf1949f36..5254bf6e6a39334737cc5e536dcdc3e2dcb1723d 100644
--- a/README.md
+++ b/README.md
@@ -3,3 +3,165 @@ The HTML and JS for Anki card templates are developed here.
 
 Part of the templates is animation and other data on many chinese characters.
 
+## What does it look like?
+There are different kinds, from simple Q/A cards to more complex cards
+specially crafted for learning Chinese or other purposes.
+
+A card for practicing writing, with details opened for the first:
+
+<img src="screenshots/example_molaoshi.png" alt="Writing" width="400">
+
+A simple Q/A card:
+
+<img src="screenshots/example_facts.png" alt="Q/A" width="400">
+
+The design philosophy is for the card templates to be simple first, for
+learners, card authors, and developers (in that order). Extra information on
+top of the simple view should be just a click away but hidden per default.
+For instance, the stroke kinds for the animation shown above are hidden per
+default to keep it simple for users. To keep it simple for card authors,
+animation data, stroke kinds, radicals etc. are included in the template and
+don't need to be filled in manually.
+
+## Key features
+* animations for chinese characters (simplified and traditional, offline)
+* stroke type tables for chinese characters
+* see radicals of characters
+
+## What templates are available and how to use them in an Anki pack?
+
+### bijective
+Facts cards, both ways. For `A`, need to know `B`, for `B` need to know `A`.
+
+Example: learn by heart which planet is 4th from the sun, but also learn by
+heart what's the planet number of Mars (4th).
+
+#### Fields
+* `A`: Question/answer
+* `B`: Question/answer
+* `Credits`: Give credit to your source here
+
+#### Note types
+* `Forward`: asks for _B_, given _A_
+* `Backward`: asks for _A_, given _B_
+
+#### Example
+```
+content_version: 1.0.0
+
+templates:
+- bijective
+
+content:
+- import_csv:
+    note_type: Bijection
+    content_version: 2024-06-08 18:23:00+00:00
+    file_patterns:
+    - 'content.csv'
+    delimiter: ';'
+    deck_name_pattern: 'Tapir geography'
+    fields_mapping:
+    - guid
+    - A
+    - B
+    fields_static: {}
+    tags: []
+
+resource_paths: []
+```
+
+### facts
+Q/A knowledge. `Front` is a question and `Back` is an answer.
+
+#### Fields
+* `Front`: Question
+* `Back`: Answer
+* `Credits`: Give credit to your source here
+
+#### Note types
+* `Q/A`: Asks the question
+
+#### Example
+```
+content_version: 1.0.0
+
+templates:
+- facts
+
+content:
+- import_csv:
+    content_version: 2024-06-08 18:23:00+00:00
+    note_type: Facts
+    file_patterns:
+    - '*.csv'
+    delimiter: ';'
+    deck_name_pattern: 'Tapir facts'
+    fields_mapping:
+    - guid
+    - Front
+    - Back
+    fields_static: {}
+    tags: []
+
+resource_paths: []
+```
+
+### hanzi
+Built for Heisig/Richardson books: asks a key word for a character, showing a
+frame number. The Hanzi animation is large and optimized for single characters.
+
+#### Fields
+* `Keyword`: Key word on the front
+* `Keyword type`: e.g. _n._, shown in parentheses after key word
+* `Notes (Front)`: Extra section on the front for custom clarifications or notes
+* `Hanzi`: Chinese character
+* `Book`: 1 or 2 for the book number
+* `Lesson`: Lesson number
+* `Frame`: Frame number shown on the top
+* `Order (Sequential)`: Order if studying book 1 and then book 2
+* `Order (Parallel)`: Order if studying book 1 and 2 simultaneously
+* `Notes (Back)`: Extra section on the back for custom clarifications or notes
+* `Traditional`: If non-empty, use traditional versions of characters
+* `Simplified`: Unused
+* `Credits`: Give credit to your source here
+
+#### Note types
+- `Schreiben`
+
+#### Example
+TODO
+
+### molaoshi
+Built for learning Chinese writing, reading, listening, speaking, recognizing
+radicals.
+
+#### Fields
+* `Deutsch`: German or other non-Chinese
+* `简体字`: Simplified chinese characters
+* `繁體字`: Traditional chinese characters
+* `Pīnyīn`: Chinese
+* `Bemerkungen`: Extra section on the back for custom clarifications or notes
+* `Beispiele`: Extra section on the back
+* `Lektion`: Unused
+* `Bemerkungen (Vorderseite)`: Extra section on the front for custom clarifications or notes
+* `Standardaussprache`: Used for TTS e.g. in listening
+* `Audioaufnahme`: Unused
+* `Radikal finden anlegen`: If non-empty, add a card for recognizing the radical of the simplified character
+* `Radikal finden (繁體字) anlegen`: If non-empty, add a card for recognizing the radical of the traditional character
+* `Schreiben anlegen`: If non-empty, add a card for writing the simplified character down
+* `Zhuyin`: Unused
+* `Lesen (繁體字) anlegen`: If non-empty, add a card for reading the traditional character down
+* `Credits`: Give credit to your source here
+
+#### Note types
+* `hear`
+* `identify_radical`
+* `identify_radical_traditional`
+* `read_hanzi`
+* `read_hanzi_traditional`
+* `read_pinyin`
+* `speak`
+* `write`
+
+#### Example
+TODO
\ No newline at end of file
diff --git a/screenshots/example_facts.png b/screenshots/example_facts.png
new file mode 100644
index 0000000000000000000000000000000000000000..9f6f25eb4ec9e6b3f0337b4c5f8a1131808134d9
Binary files /dev/null and b/screenshots/example_facts.png differ
diff --git a/screenshots/example_molaoshi.png b/screenshots/example_molaoshi.png
new file mode 100644
index 0000000000000000000000000000000000000000..f63ef85296712431064f1a2bdb6cacb1d66d0eb6
Binary files /dev/null and b/screenshots/example_molaoshi.png differ
diff --git a/src/templates/bijective/.template-spec.yaml b/src/templates/bijective/.template-spec.yaml
index 0074aaa735dc1301e5b5b4288a5815cf301f802a..4976c213260bde4d5a1c30bbb8912f67ecf479ae 100644
--- a/src/templates/bijective/.template-spec.yaml
+++ b/src/templates/bijective/.template-spec.yaml
@@ -7,6 +7,7 @@ note_type:
   - A
   - B
   - Credits
+  - resources
 
 card_types:
 - name: Forward
diff --git a/src/templates/facts/.template-spec.yaml b/src/templates/facts/.template-spec.yaml
index b7796d519b44f2a55493e046fbdf9b868b5aee27..b31352f2ab7b0222051971b1590493f67f18671c 100644
--- a/src/templates/facts/.template-spec.yaml
+++ b/src/templates/facts/.template-spec.yaml
@@ -7,6 +7,7 @@ note_type:
   - Front
   - Back
   - Credits
+  - resources
 
 card_types:
 - name: Q/A