README: Update usage and deployment docs

Author: NMertsch

README.md

@@ -47,10 +47,12 @@ Cache files (will be created if necessary):
 * `pretix_cache.json`: Local cache of Pretix ticket data
 * `schedule_cache.json`: Local cache of [programapi](https://github.com/europython/programapi) schedule
 
-## Setup
-### Quickstart using `pip`
+## Usage
 
-If you just want to try the bot and skip the development setup, you can use `pip` (requires Python >= 3.11):
+This section describes how to install and run the bot.
+Please see below for development and EuroPython-specific deployment instructions.
+
+With pip:
 
 ```shell
 # create and activate virtual environment (optional, but recommended)
@@ -65,10 +67,24 @@ export DISCORD_BOT_TOKEN=...  # Windows: $env:DISCORD_BOT_TOKEN = '...'
 export PRETIX_TOKEN=...  # Windows: $env:PRETIX_TOKEN = '...'
 
 # run the bot with a given config file
-run-bot --config your-config-file.toml
+run-bot --config-file your-config-file.toml
+```
+
+With uv:
+
+```shell
+# install dependencies in virtual environment
+uv sync
+
+# set environment variables
+export DISCORD_BOT_TOKEN=...  # Windows: $env:DISCORD_BOT_TOKEN = '...'
+export PRETIX_TOKEN=...  # Windows: $env:PRETIX_TOKEN = '...'
+
+# run the bot with a given config file
+uv run run-bot --config-file your-config-file.toml
 ```
 
-### Full Development Setup
+## Full Development Setup
 
 * Install `uv` as documented [here](https://docs.astral.sh/uv/getting-started/installation/).
 * Run `uv sync --dev` to create/update a virtual environment with all dependencies according to [`uv.lock`](./uv.lock).
@@ -87,7 +103,7 @@ export PRETIX_TOKEN=...  # Windows: $env:PRETIX_TOKEN = '...'
 run-bot --config your-config-file.toml
 ```
 
-#### Working with `uv`
+### Working with `uv`
 
 This is a list of useful commands when working with `uv`.
 Please refer to the [uv documentation](https://docs.astral.sh/uv) or `uv help` for details.
@@ -123,15 +139,23 @@ uv remove [package]
 * Check code style: `ruff check .`
 * Run tests: `pytest`
 
-### Deployment
+## Deployment
 
-The bot is deployed on a VPS using a GitHub Action.
+For the EuroPython conference, this bot is deployed on a VPS.
 It uses Ansible to configure the VPS, and Docker Compose to run the bot.
+The deployment process is executed via a GitHub Action.
 
 Related files:
 
-* [.github/workflows/deploy.yml](./.github/workflows/deploy.yml): The GitHub Action
-* [ansible/deploy-playbook.yml](./ansible/deploy-playbook.yml): The Ansible Playbook
-* [Dockerfile](./Dockerfile): The Docker container recipe
-* [compose.yaml](./compose.yaml): The Docker Compose recipe
-* [prod-config.toml](./prod-config.toml): The Prod bot configuration
+* In this repository:
+    * [.github/workflows/deploy.yml](./.github/workflows/deploy.yml): GitHub Action
+    * [ansible/deploy-playbook.yml](./ansible/deploy-playbook.yml): Ansible Playbook
+    * [Dockerfile](./Dockerfile): Docker container recipe
+    * [compose.yaml](./compose.yaml): Docker Compose recipe
+    * [prod-config.toml](./prod-config.toml): Prod bot configuration
+* On the VPS:
+    * `/root/.secrets`: Contains `DISCORD_BOT_TOKEN` and `PRETIX_TOKEN`
+    * `/root/livestreams.toml`: Livestream URL configuration
+    * `/home/bot/registered_log.txt`: Registration log
+    * `/home/bot/pretix_cache.json`: Pretix cache
+    * `/home/bot/schedule_cache.json`: Program cache