some documentation texts

Author: malytomas

sphinx/source/bots/setup.rst

@@ -6,6 +6,9 @@ The shared library is distributed together with the game.
 The uwapi repository contains c/c++ headers for all functions and structures provided by the library.
 Furthermore, it contains convenient wrappers for Python and C# for easy start.
 
+Steam Appid Txt
+---------------
+
 .. important::
 	Copy ``steam_appid.txt`` into the ``bin`` folder.
 
@@ -16,6 +19,12 @@ You may also start the game client, game server, built-in AI, or any other assoc
 You will find the ``steam_appid.txt`` in the uwapi repository.
 Copy it into the ``bin`` folder, next to the game executable.
 
+It is recommended to remove the ``steam_appid.txt`` when you are done with your AI/bot program.
+The file may cause corruptions when the game is updated.
+
+Game Install Path
+-----------------
+
 .. important::
 	If you installed Unnatural World in non-default location, define environment variable ``UNNATURAL_ROOT`` to the directory containing the library.
 

sphinx/source/bots/troubleshooting.rst

@@ -29,3 +29,13 @@ Troubleshooting
 	.. code-block:: bash
 
 		__NV_PRIME_RENDER_OFFLOAD=1 __GLX_VENDOR_LIBRARY_NAME=nvidia your_program
+
+	Alternatively, define these two environment variables in your IDE to be used when debugging your program.
+
+.. dropdown:: Corrupted game files
+
+	Shut down Steam - click on the icon in the status bar, choose *Exit Steam*.
+	Make sure that no Steam processes are running.
+	Remove the whole folder ``Unnatural Worlds`` with the game.
+	Start steam again, select UW in the library, click the settings (looks like a gear), *Properties...*, in the pop-up window select *Installed Files* tab, and click *Verify integrity of game files*.
+	This will force Steam to download the whole game again.

sphinx/source/concepts/map.rst

@@ -21,7 +21,7 @@ Clusters
 --------
 Clusters are aggregations of tiles into smaller connected groups.
 It is intended primarily for performance optimizations.
-All tiles in one cluster have the same terrain.
+All tiles in one cluster have same terrain.
 
 Clusters are indexed `0 .. M-1`.
 

sphinx/source/concepts/prototypes.rst

@@ -16,7 +16,7 @@ It contains amounts and ids of inputs and outputs.
 Also defines the duration of the recipe.
 Recipes are processed in buildings/units.
 
-Some recipes have a *place-over* requirement, which is an id of a unit, that the building must be placed on, in order for the recipe to function.
+Some recipes have a *place-over* requirement, which is an id of a unit prototype, that the building must be placed on, in order for the recipe to operate.
 
 Construction Prototype
 ----------------------

sphinx/source/conf.py

@@ -6,7 +6,7 @@
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
-project = 'UW api'
+project = 'UW API'
 copyright = '2025, Tomáš Malý'
 author = 'Tomáš Malý'
 

sphinx/source/mods/index.rst

@@ -12,6 +12,6 @@ When players are starting a game, they can enable/disable individual mods in the
 Consequently, multiple mods can be enabled simultaneously.
 
 Assets found in a mod have precedence over assets in a map or in the base game.
-However, when multiple mods contain same asset ID, the map will fail to load.
-Managing mods with clashing assets IDs is left to the player.
-It is advised to prefix names of all assets in a mod with the name of the mod, to reduce a chance of clashing IDs.
+However, when multiple mods contain same asset id, the map will fail to load.
+Managing mods with clashing assets ids is left to the player.
+It is advised to prefix names of all assets in a mod with the name of the mod, to reduce a chance of clashing ids.