Document the world (#46495)

code/controllers/master.dm

@@ -8,6 +8,7 @@
  **/
 
 //This is the ABSOLUTE ONLY THING that should init globally like this
+//2019 update: the failsafe,config and Global controllers also do it
 GLOBAL_REAL(Master, /datum/controller/master) = new
 
 //THIS IS THE INIT ORDER

code/game/world.dm

@@ -2,8 +2,22 @@
 
 GLOBAL_VAR(restart_counter)
 
-//This happens after the Master subsystem new(s) (it's a global datum)
-//So subsystems globals exist, but are not initialised
+/**
+  * World creation
+  *
+  * Here is where a round itself is actually begun and setup, lots of important config changes happen here
+  * * db connection setup
+  * * config loaded from files
+  * * loads admins
+  * * Sets up the dynamic menu system
+  * * and most importantly, calls initialize on the master subsystem, starting the game loop that causes the rest of the game to begin processing and setting up
+  *
+  * Note this happens after the Master subsystem is created (as that is a global datum), this means all the subsystems exist,
+  * but they have not been Initialized at this point, only their New proc has run
+  * 
+  * Nothing happens until something moves. ~Albert Einstein 
+  * 
+  */
 /world/New()
 
 	log_world("World loaded at [time_stamp()]!")
@@ -329,4 +343,4 @@ GLOBAL_VAR(restart_counter)
 
 
 /world/proc/on_tickrate_change()
-	SStimer?.reset_buckets()
+	SStimer?.reset_buckets()

code/world.dm

@@ -1,6 +1,15 @@
 //This file is just for the necessary /world definition
 //Try looking in game/world.dm
 
+/**
+  * # World
+  *
+  * Two possibilities exist: either we are alone in the Universe or we are not. Both are equally terrifying. ~ Arthur C. Clarke
+  *
+  * The byond world object stores some basic byond level config, and has a few hub specific procs for managing hub visiblity
+  *
+  * The world /New() is the root of where a round itself begins
+  */
 /world
 	mob = /mob/dead/new_player
 	turf = /turf/open/space/basic