diff --git a/readme.md b/readme.md
index d3f99f8..2cffcc6 100644
--- a/readme.md
+++ b/readme.md
@@ -11,7 +11,7 @@ Massive rewrite/extension: Sokomine
License: GPLv3.0 or later (see LICENSE)
-Reporting bugs: TODO
+Reporting bugs: Please report issues here.
Clone via i.e. `git clone https://gitea.your-land.de/Sokomine/yl_speak_up`
or install via ContentDB.
@@ -181,6 +181,13 @@ menu. You can reach it by clicking on the button of the option, i.e. on `o_1`.
off with `/npc_talk debug off`. The NPC ID can be seen in the
setup dialog for preconditions and effects.
+The text the NPC says is written in the markup language Minetest uses. See
+lua_api.md
+for more details. You can use the elements of that markup language for the
+text that the NPC says, i.e.
+ `
`
+will display the image `default_cobble.png`.
+
### 1.4 Skin
@@ -594,7 +601,7 @@ There is an NPC that explains a few things and adds as a tutuor.
The savefile is: `n_1.json`
Copy that file to the folder
- `/yl_speak_up_dialogs/n_1.json`
+ `/yl_speak_up_dialogs/n_1.json`
(replace the 1 with a higher number if you already have some NPC defined).
The first NPC in your world will now become a tutor (after you spawned it