--- a/LuaAPI.wiki	Thu Apr 04 13:52:44 2019 +0100
+++ b/LuaAPI.wiki	Thu Apr 04 14:10:24 2019 +0100
@@ -1507,6 +1507,8 @@
 
 `caption` is the text displayed in the first line, `subcaption` is displayed in the second line and `text` is the text displayed in the third and following lines.
 
+By convention, `caption` should *normally* contain the name of the game style or mission and `subcaption` should *normally* contain the type of game style or mission, or a witty tagline. But this is only a loose convention which you don't have to follow all the time.
+
 `text` uses some special characters for formatting:
 
 || *Special character* || *Meaning* ||