Tweak docs

Author: LEDfan

docs/README.md

@@ -0,0 +1,5 @@
+# Docs
+
+- [Deployment (with examples)](deployment/)
+- [Behavior in combination with ShinyProxy](shinyproxy.md)
+- [Prometheus monitoring](prometheus.md)

docs/prometheus.md

@@ -9,13 +9,13 @@ Before diving into the details, have a look at the setup of Prometheus
 monitoring with ShinyProxy in a [regular deployment](https://shinyproxy.io/documentation/usage-statistics/#micrometer).
 
 Because the operator is meant to dynamically create ShinyProxy servers, it does
-not suffice to configure static list of ShinyProxy servers in Prometheus.
-Fortunately, Prometheus has the concept of [Service Discover](https://prometheus.io/docs/prometheus/latest/configuration/configuration/),
+not suffice to configure a static list of ShinyProxy servers in Prometheus.
+Fortunately, Prometheus has the concept of [Service Discovery](https://prometheus.io/docs/prometheus/latest/configuration/configuration/),
 which allows Prometheus to automatically *discover* ShinyProxy servers. We
 assume here that Prometheus is running in the same Kubernetes cluster as the
 ShinyProxy operator.
 
-What follows is an example configuration of Prometheus:
+Example Prometheus configuration:
 
 ```yaml
 scrape_configs:

docs/shinyproxy.md

@@ -34,11 +34,11 @@ latest server.
 the latest version.
 - a message on the main page of ShinyProxy is shown:
 
-  ![Message on the app page](../../.github/screenshots/message_main_page.png)
+  ![Message on the app page](../.github/screenshots/message_main_page.png)
 
 - a message on the app page of ShinyProxy is shown:
 
-  ![Message on the app page](../../.github/screenshots/message_app_page.png)
+  ![Message on the app page](../.github/screenshots/message_app_page.png)
 
 - after clicking the button on the message the user is transferred to the latest
   ShinyProxy server
@@ -97,7 +97,7 @@ server. This server will then redirect to the OpenID provider.
   the latest ShinyProxy server
 
 **Note:** this only works when the `proxy.operator.force-transfer` option is set
-to `true` (in the ShinyProxy configuration).
+to `true` (in the ShinyProxy configuration). By default this option is disabled.
 
 ### Scenario 5: Starting an app