documentation: program safety

Author: malytomas

sphinx/source/bots/index.rst

@@ -9,4 +9,5 @@ Specifically, bots cannot cheat - no more than a regular player could.
 .. toctree::
 	setup
 	programOverview
+	programSafety
 	troubleshooting

sphinx/source/bots/programSafety.rst

@@ -0,0 +1,20 @@
+Program Safety
+==============
+Memory and threads guarantees of the api.
+
+Memory
+------
+
+Memory ownership is never transferred across the api boundary.
+Usually, any pointers returned from any of the *c* functions are valid until next call to the same function.
+Therefore, most *c* functions are *not* reentrant.
+
+The Python and C# wrappers functions always copy all necessary memory from the provided pointers into the native memory of the language.
+Be careful if you use a *c* function directly.
+
+Threads
+-------
+
+.. important::
+	The api is strictly singlethreaded!
+

sphinx/source/bots/setup.rst

@@ -39,3 +39,12 @@ Game Install Path
       :sync: linux
 
       Default path: ``~/.steam/steam/steamapps/common/Unnatural Worlds/bin``
+
+Show Extra Information
+----------------------
+
+In the game, navigate to *Options*, *User Interface*, and change *Selected info level* to *Extra*.
+This will show you additional information about any single thing you select in the game.
+For example: unit id, its state, position (both index and 3D coordinates), etc.
+It shows at the bottom of the left panel.
+