sphinx theme furo

Author: malytomas

README.md

@@ -1,2 +1,4 @@
 # uwapi
 Language bindings for writing AI bots and scripts for Unnatural Worlds.
+
+Documentation is at: https://unnatural-worlds.github.io/uwapi/

sphinx/requirements.txt

@@ -1 +1,2 @@
 sphinx_design
+furo

sphinx/source/bots/index.rst

@@ -8,5 +8,9 @@ The uwapi repository contains c/c++ headers for all functions and structures pro
 
 The uwapi repository also contains convenient wrappers for Python and for C# for quicker start of writing your bot.
 
+The bots api is designed such that you retain full control over your bot program - aka it makes it possible to develop and debug it the way you are used to.
+However, to be able to start the game outside of the Steam, it is necessary to copy the file ``steam_appid.txt`` (contained in the uwapi repository) into the ``bin`` folder, next to the game executable.
+This also allows you to start the game, and all other accompanying programs, from command line or from bash, which allows you to manually start the server, and connect any number of bots and human players.
+
 .. toctree::
 	troubleshooting

sphinx/source/bots/troubleshooting.rst

@@ -8,14 +8,14 @@ Troubleshooting
 
 	Make sure you have installed Unnatural Worlds in Steam.
 
-	If your Steam games are in a non-default location, define the environment variable ``UNNATURAL_ROOT`` to the directory containing the library.  
+	If your Steam games are in non-default location, define the environment variable ``UNNATURAL_ROOT`` to the directory containing the library.  
 	Example: ``C:\Program Files (x86)\Steam\steamapps\common\Unnatural Worlds\bin``
 
 .. dropdown:: OSError: cannot load library 'unnatural-uwapi-hard'
 
 	Make sure you have installed Unnatural Worlds in Steam.
 
-	If your Steam games are in a non-default location, define the environment variable ``UNNATURAL_ROOT`` to the directory containing the library.  
+	If your Steam games are in non-default location, define the environment variable ``UNNATURAL_ROOT`` to the directory containing the library.  
 	Example: ``C:\Program Files (x86)\Steam\steamapps\common\Unnatural Worlds\bin``
 
 .. dropdown:: Failed to initialize Steam API

sphinx/source/conf.py

@@ -6,7 +6,7 @@
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
-project = 'uwapi'
+project = 'UW api'
 copyright = '2025, Tomáš Malý'
 author = 'Tomáš Malý'
 
@@ -29,5 +29,5 @@
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
-html_theme = 'alabaster'
+html_theme = 'furo'
 html_static_path = ['_static']

sphinx/source/index.rst

@@ -9,6 +9,17 @@ Documentation for user-generated content for the game Unnatural Worlds.
 	All user-generated content requires full version of the game.
 	It will not work with the Demo.
 
+Useful Links
+------------
+- `Steam Page <https://store.steampowered.com/app/2369780/Unnatural_Worlds/>`_
+- `Steam Workshop <https://steamcommunity.com/app/2369780/workshop/>`_
+- `Discord <https://discord.gg/RjHFk3vQYG>`_
+- `Reddit <https://www.reddit.com/r/unnaturalworlds/>`_
+- `Github <https://github.com/unnatural-worlds>`_
+- `UW Homepage <https://unnaturalworlds.com/>`_
+
+Index
+-----
 .. toctree::
 	:maxdepth: 2
 
@@ -17,12 +28,3 @@ Documentation for user-generated content for the game Unnatural Worlds.
 	mods/index
 	scripts/index
 	bots/index
-
-External Links
---------------
-- `Steam Page <https://store.steampowered.com/app/2369780/Unnatural_Worlds/>`_
-- `Steam Workshop <https://steamcommunity.com/app/2369780/workshop/>`_
-- `Discord <https://discord.gg/RjHFk3vQYG>`_
-- `Reddit <https://www.reddit.com/r/unnaturalworlds/>`_
-- `Github <https://github.com/unnatural-worlds>`_
-- `Homepage <https://unnaturalworlds.com/>`_

sphinx/source/maps/index.rst

@@ -8,6 +8,8 @@ Guide on making custom maps for Unnatural Worlds.
 A map for UW is a collection of assets, and some additional required files.
 It may contain :ref:`prototypes <Prototypes>`, :ref:`scripts <Scripts>`, models, sounds, etc.
 
+Assets found in a map have precedence over assets in the base game.
+
 Additional files in the map
 ---------------------------
 .. toctree::