update dialog box doc

Author: Frotty

_doc/stdlib/dialogbox.md

@@ -2,7 +2,7 @@
 title: Dialog Box
 layout: stdlibdoc
 color: blue
-date: 2019-02-04
+date: 2025-01-15
 sections:
   - /stdlib/util/dialogbox
 ---

_doc/stdlib/util/dialogbox.md

@@ -12,20 +12,22 @@ sections:
 In warcraft III a dialog refers to a modal dialog that is shown to players with a message text and various buttons to click.
 Dialogs have several drawbacks, such as disabling user input and chat, and thus should only be seldomly used in multiplayer.
 
+> Dialogs cannot be created during map init!
+
 ### The DialogBox
 
 If you want to create a dialog though, make use of the `DialogBox` class. You can eiher reuse the same `DialogBox` and use `GetTriggerPlayer()` to get the player in the click event:
 
 ```wurst
 init
-	let dBox = new DialogBox("Are you a noob?")
-	dBox.addButton("Yes") ->
-		GetTriggerPlayer()..addGold(500)..display(GetTriggerPlayer(), false)
-
-	dBox.addButton("No", () -> dBox.display(GetTriggerPlayer(), false))
-
+  // Can't create Dialogs during map init
 	doAfter(0.1) ->
-		// Don't call display during init
+        let dBox = new DialogBox("Are you a noob?")
+        dBox.addButton("Yes") ->
+            GetTriggerPlayer()..addGold(500)
+            dBox.display(GetTriggerPlayer(), false)
+
+        dBox.addButton("No", () -> dBox.display(GetTriggerPlayer(), false))
 		for i = 0 to 11
 			dBox.display(players[i], true)
 ```
@@ -34,12 +36,14 @@ init
 Example with global and display on spellcast:
 
 ```wurst
-constant GOLD_BOX = new DialogBox("Extra starting gold?")
+DialogBox goldBox
 
 init
-	// add buttons
-	dBox.addButton("Yes") ->
-		...
+  doAfter(0.1) ->
+    goldBox = new DialogBox("Extra starting gold?")
+	  // add buttons
+	  dBox.addButton("Yes") ->
+		  ...
 
 	EventListener.onCast(SPELL_ID) (caster) ->
 		GOLD_BOX.display(caster, true)

_sass/doc.scss

@@ -29,6 +29,7 @@
 
 .doc-header {
   margin-bottom: 48px;
+  margin-top: 48px;
   .doc-title {
     color: var(--color-primary);
     margin-top: 0;