docs/deployment.md

@@ -0,0 +1,11 @@
+# Deployment
+
+Bare minimum installation requires a database and an API. Then you can use any way you like to connect to the API.
+We provide Telegram bot and raw HTTP for that now, but Discord bot and CLI are planned too.  
+
+Here is how the "normal" deployment process looks like:
+
+1. Install the requirements [[API](api/installation.md#requirements)/[Telegram](bot_telegram/installation.md#requirements)]
+2. Install the API server [[Guide](api/installation.md)]
+3. Install the client/bot of your linking [[Telegram](bot_telegram/installation.md)]
+4. Fill the API/bot with the data [[API](api/feeding-data.md)/[Telegram](bot_telegram/feeding-data.md)]

docs/index.md

@@ -13,15 +13,3 @@ We provide chatbots as clients. These bots provide the access to the data stored
 After seeing that most cities and villages around only offer proprietary software/websites or even no digital information
 about garbage collection at all, it was decided to develop an own solution to this problem by storing the data in a
 database and then show the data the way it is helpful for the end-user.
-
-## Deployment
-
-Bare minimum installation requires a database and an API. Then you can use any way you like to connect to the API.
-We provide Telegram bot and raw HTTP for that now, but Discord bot and CLI are planned too.  
-
-Here is how the "normal" deployment process looks like:
-
-1. Install the requirements [[API](api/installation.md#requirements)/[Telegram](bot_telegram/installation.md#requirements)]
-2. Install the API server [[Guide](api/installation.md)]
-3. Install the client/bot of your linking [[Telegram](bot_telegram/installation.md)]
-4. Fill the API/bot with the data [[API](api/feeding-data.md)/[Telegram](bot_telegram/feeding-data.md)]

docs/start-using.md

@@ -0,0 +1,17 @@
+# Start using
+
+There are two common usage scenarios: using public instance and deploying your own.
+
+## Using public instance
+
+While limited in coverage, public instance offers the access to the latest stable version of the API and chat-bots.  
+
+* [Public API](https://api.garbagebot.eu)
+* [Public Telegram Bot](https://t.me/GarbageReminder_Bot)
+
+You can find out more about public instance in the [Public instance](community/public/index.md) section.
+
+## Deploying own instance
+
+For more personalized experience, you can deploy your own API and clients wherever you want to.
+Follow the [deployment guide](deployment.md) for detailed instructions.

mkdocs.yml

@@ -4,6 +4,8 @@ repo_name: GarbageReminder
 nav:
   - Home:
     - index.md
+    - Start using: start-using.md
+    - Deployment: deployment.md
   - API:
     - api/index.md
     - Installation: api/installation.md
@@ -77,21 +79,21 @@ theme:
   palette:
     - media: "(prefers-color-scheme)"
       toggle:
-        icon: material/link
+        icon: material/brightness-auto
         name: Switch to light mode
     - media: "(prefers-color-scheme: light)"
       scheme: default
       primary: custom
       accent: custom
       toggle:
-        icon: material/toggle-switch
+        icon: material/brightness-7
         name: Switch to dark mode
     - media: "(prefers-color-scheme: dark)"
       scheme: slate
       primary: custom
       accent: custom
       toggle:
-        icon: material/toggle-switch-off
+        icon: material/brightness-5
         name: Switch to system preference
   font:
     text: Roboto