diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index eef3c63..23d10c1 100755
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -74,7 +74,7 @@ There are a few rules for working in the Water.css source code:
 
 3. Reuse existing colors where possible. Before introducing a new color to our palette, check if one of the existing colors fits your needs.
 
-4. If you introduce a new variable, make sure to declare it both in `variables-dark.css` and `variables-light.css` so it's available in both themes.
+4. If you introduce a new variable, make sure to declare it both in `variables-dark.css` and `variables-light.css` so it's available in both themes. Also, add the new variable to the list of variables available for theming in the [README](../README.md#theming).
 
 ## Create your pull request
 
diff --git a/README.md b/README.md
index 6e585ce..84801b5 100644
--- a/README.md
+++ b/README.md
@@ -74,8 +74,28 @@ Simply remove the `.min` from the file name.
 
 ## Theming
 
-Do you want to make some adjustments or build your own theme completely different from the official dark or light themes? Since Water.css is built with CSS variables this is super easy to do!
-You can find a full list of the variables used at [**src/variables-\*.css**](https://github.com/kognise/water.css/tree/master/src/variables-dark.css).
+Do you want to make some adjustments or build your own theme completely different from the official dark or light themes? Since Water.css is built with CSS variables this is super easy to do! Here's a list list of all the variables you can change to your liking:
+
+- `--background-body`
+- `--background`
+- `--background-alt`
+- `--selection`
+- `--text-main`
+- `--text-bright`
+- `--text-muted`
+- `--links`
+- `--focus`
+- `--border`
+- `--code`
+- `--animation-duration`
+- `--button-hover`
+- `--scrollbar-thumb`
+- `--scrollbar-thumb-hover`
+- `--form-placeholder`
+- `--form-text`
+- `--variable`
+- `--highlight`
+- `--select-arrow`
 
 ### Runtime theming