diff --git a/modules/environment/README.md b/modules/environment/README.md
new file mode 100644
index 0000000..1b0f972
--- /dev/null
+++ b/modules/environment/README.md
@@ -0,0 +1,18 @@
+Environment
+===========
+
+Sets generic Zsh built-in environment options.
+
+Also enables smart url-pasting. This prevents the user from having to manually escape URLs.
+
+ZSH Options
+-----------
+
+| Option | Effect |
+| ------ | ------ |
+| AUTO_RESUME | Resume existing jobs before creating a new job |
+| LONG_LIST_JOBS | Use the verbose list format by default |
+| NOTIFY | Report job status immediately instead of waiting for new prompt |
+| BG_NICE | Disabled to prevent jobs being given a lower priority |
+| HUP | Disabed to prevent SIGHUP to jobs on shell close |
+| CHECK_JOBS | Disabled to prevent job report on shell close |