diff --git a/docs/README b/docs/README
index 284ce527..f049a49f 100644
--- a/docs/README
+++ b/docs/README
@@ -27,6 +27,10 @@ Copy the example config file to ircd.yaml with a command like:
 
 Modify the config file as you like.
 
+To generate passwords for opers and connect passwords, you can use this command:
+
+    $ oragono genpasswd
+
 Run these commands in order -- these will setup each section of the server:
 
     $ oragono initdb
@@ -34,3 +38,14 @@ Run these commands in order -- these will setup each section of the server:
     $ oragono run
 
 And you should now be running Oragono!
+
+
+=== Updating ===
+
+If you're updating from a previous version of Oragono, checkout the CHANGELOG for a shortlist
+of important changes you'll want to take a look at. The change log details config changes,
+fixes, new features and anything else you'll want to be aware of!
+
+If there's been a database update, you'll also need to run this command:
+
+    $ oragono upgradedb