DOC: Add documentation for Bot module.

Author: hhslepicka

docs/api/bot.md

@@ -0,0 +1,47 @@
+# Bot API
+
+This module containes the base class for all bots `BaseBot` but also
+specialized implementations such as `DesktopBot` which is described below.
+
+You are expected to implement the `action` method of the `DesktopBot` class in
+your Bot class.
+
+Here is a very brief example of a bot which opens the BotCity website:
+
+```python
+from botcity.core import DesktopBot
+
+
+class Bot(DesktopBot):
+    def action(self, execution):
+        # Opens the BotCity website.
+        self.browse("https://botcity.dev/en")
+
+
+if __name__ == '__main__':
+    Bot.main()
+```
+
+
+All functions from the API described below are accessible via the bot class as 
+methods without the need to import any other module.
+
+E.g.:
+
+```python
+class Bot(DesktopBot):
+    def action(self, execution):
+        # using browse from browser module
+        self.browse(...)
+        # using find from display module
+        self.find(...)
+        # using mouse_move from mouse module
+        self.mouse_move(x=100, y=200)
+        # using enter from keyboard module
+        self.enter()
+
+```
+
+## DesktopBot API
+
+::: botcity.core.bot.DesktopBot

docs/api/index.md

@@ -12,6 +12,7 @@ The API is divided into the following modules:
 
 - *misc*: this module contains miscellaneous functions such as executing applications, and wait/print.
 
+- *bot*: this module contains the base class for Bots, including the DesktopBot
 
 In order to make it easy for users, all modules are available
 via the core module.

docs/intro.md

@@ -19,7 +19,15 @@ which takes as argument a URL.
 browser("https://www.botcity.dev/en")
 ```
 
+## Template Project
+
+We created a template project using Cookiecutter to help
+you create new bots using BotCity's Python Framework.
+
+Take a look into the [template project website](https://github.com/botcity-dev/bot-python-template) for more information
+on how to use it and get started.
+
 ## Next Steps
 
-Check our example and experiment with the API.
-Let us know where it can be improved.
+Check our examples and experiment with the API.
+Let us know where it can be improved.

mkdocs.yml

@@ -13,6 +13,7 @@ nav:
         - 'Mouse': api/mouse.md
         - 'Keyboard': api/keyboard.md
         - 'Misc': api/misc.md
+        - 'Bot': api/bot.md
 theme:
   icon:
     repo: fontawesome/brands/github
@@ -35,6 +36,10 @@ theme:
         icon: material/toggle-switch
         name: Switch to light mode
 
+markdown_extensions:
+  - pymdownx.highlight
+  - pymdownx.superfences
+
 extra:
   generator: false
   social: