explained alternate texts

README.md

@@ -20,6 +20,8 @@ action           An action the player may (or may not) take, i.e. trading,
 effect/result    Further effects (like setting variables, handing out items)
                  that take place after the action was successful.
 
+alternate text   Text shown instead of the normal dialog text.
+
 How to configure NPC and add dialogs
 ====================================
 There are two ways:
@@ -193,3 +195,22 @@ take a look at
 	custrom_functions_you_can_override.lua
 In order to add custom functions, you need to be able to edit that file or
 execute Lua code on the server.
+
+Alternate Text
+==============
+Sometimes you may encounter a situation where your NPC ought to answer to
+several questions and the player likely wanting an answer to each. In such
+a situation, you might create a dialog text for each possible option/answer
+and add an option to each of these new dialogs like "I have more questions.".
+That is sometimes impractical. Therefore, you can add alternate texts.
+
+These alternate texts can be shown instead of the normal dialog text when the
+player selected an option/answer. Further alternate texts can be shown if
+the action (provided there is one defined for the option) or an effect failed.
+
+The alternate text will override the text of the dialog (what the NPC says)
+but offer the same options/answers as the dialog normally would.
+
+Alternate texts can be converted to normal dialogs, and normal dialogs can
+vice versa be converted to alternate texts if only one option/answer points
+to them.