diff --git a/Temperature.md b/Temperature.md
new file mode 100644
index 0000000..253bf24
--- /dev/null
+++ b/Temperature.md
@@ -0,0 +1,19 @@
+# temperature
+
+##### Access: Public<small>\*</small>
+-----
+
+This command is used to display the current temperature<small>\**</small>, or to set the thermostat to a more suitable temperature. 
+
+<small>\* The ability to retrieve the temperature is public, while only bot owners may adjust the thermostat.</small>
+
+<small>\** The bot/plugin will set a random temperature between 20-29°C when initialized (bot restart, plugin reload).  The temperature is not *currently* stored/persistent.
+
+-----
+
+Usage:  `/temperature [new temperature]` or `.temperature [new temperature]`
+
+*`new temperature` is optional, and may only be used by bot owners as described above to adjust the thermostat.
+
+<small>Temperatures are expected in °C, and the bot currently insists that the temperature not be set lower than -15°C or higher than 35°C.</small> 
+