diff --git a/galaxy.yml b/galaxy.yml
index c557bcd..396a15a 100644
--- a/galaxy.yml
+++ b/galaxy.yml
@@ -3,7 +3,7 @@
 namespace: uumas
 name: general
 description: General roles
-version: 0.5.12
+version: 0.5.13
 readme: README.md
 authors:
   - uumas
diff --git a/roles/caddy/README.md b/roles/caddy/README.md
index b68a1f1..14f8f99 100644
--- a/roles/caddy/README.md
+++ b/roles/caddy/README.md
@@ -1 +1 @@
-Installs caddy https server
+Installs caddy
diff --git a/roles/caddy/meta/argument_specs.yaml b/roles/caddy/meta/argument_specs.yaml
index adcf61a..cf8b601 100644
--- a/roles/caddy/meta/argument_specs.yaml
+++ b/roles/caddy/meta/argument_specs.yaml
@@ -1,7 +1,7 @@
 ---
 argument_specs:
   main:
-    short_description: Installs caddy
+    description: Installs caddy
     options:
       caddy_admin_email:
         description: Email address used for ssl certs
diff --git a/roles/compatcheck/README.md b/roles/compatcheck/README.md
new file mode 100644
index 0000000..5db9818
--- /dev/null
+++ b/roles/compatcheck/README.md
@@ -0,0 +1,3 @@
+Checks that the host is runing a supported os.
+Supported distros and versions are defined by the compatcheck_supported_distros variable.
+This role is used by other roles to check compatibility.
diff --git a/roles/example/README.md b/roles/example/README.md
new file mode 100644
index 0000000..67d9467
--- /dev/null
+++ b/roles/example/README.md
@@ -0,0 +1,2 @@
+This role is just an example.
+It pings the host, if example_ping is set to true.
diff --git a/roles/prometheus_node_exporter/meta/argument_specs.yml b/roles/prometheus_node_exporter/meta/argument_specs.yml
index 923449c..32bd422 100644
--- a/roles/prometheus_node_exporter/meta/argument_specs.yml
+++ b/roles/prometheus_node_exporter/meta/argument_specs.yml
@@ -2,7 +2,7 @@
 
 argument_specs:
   main:
-    short_description: Prometheus node exporter
+    description: Installs and configures prometheus node exporter to listen on local ipv4 address
     options:
       local_network:
         description: The local ipv4 network block, listen address is taken from this block
diff --git a/roles/raw_python/README.md b/roles/raw_python/README.md
new file mode 100644
index 0000000..6056ec7
--- /dev/null
+++ b/roles/raw_python/README.md
@@ -0,0 +1 @@
+Installs python using only the raw module
diff --git a/roles/raw_python/meta/argument_specs.yaml b/roles/raw_python/meta/argument_specs.yaml
index 29bb122..87422e3 100644
--- a/roles/raw_python/meta/argument_specs.yaml
+++ b/roles/raw_python/meta/argument_specs.yaml
@@ -1,5 +1,5 @@
 ---
 argument_specs:
   main:
-    short_description: Installs python using only the raw module
+    description: Installs python using only the raw module
     options: {}
diff --git a/roles/vhost/README.md b/roles/vhost/README.md
new file mode 100644
index 0000000..c8550fd
--- /dev/null
+++ b/roles/vhost/README.md
@@ -0,0 +1,3 @@
+Sets up a vhost on a web server.
+Supports reverse proxies, redirects and simple resonses.
+Currently only supports caddy.