diff --git a/mediagoblin.ini b/mediagoblin.ini
index e878a47..3898afd 100644
--- a/mediagoblin.ini
+++ b/mediagoblin.ini
@@ -11,16 +11,23 @@ email_sender_address = "notice@mediagoblin.example.org"
 
 ## Uncomment and change to your DB's appropiate setting.
 ## Default is a local sqlite db "mediagoblin.db".
+## Don't forget to run `./bin/gmg dbupdate` after having changed it.
 # sql_engine = postgresql:///mediagoblin
 
-# set to false to enable sending notices
+# Set to false to enable sending notices
 email_debug_mode = true
 
 # Set to false to disable registrations
 allow_registration = true
 
+## Uncomment this to allow atachments.
+## Attachment are arbitrary files that are associated to a media entry.
+## However, they are not filtered or scanned so may be present risks.
+## Make sure your environment is safe before enabling it.
+# allow_attachments = true
+
 ## Uncomment this to turn on video or enable other media types
-## You may have to install dependencies, and will have to run ./bin/gmg dbupdate
+## You may have to install dependencies, and will have to run `./bin/gmg dbupdate`
 ## See http://docs.mediagoblin.org/siteadmin/media-types.html for details.
 # media_types = mediagoblin.media_types.image, mediagoblin.media_types.video
 
@@ -43,8 +50,8 @@ base_url = /mgoblin_media/
 [celery]
 # Put celery stuff here
 
-# place plugins here---each in their own subsection of [plugins]. see
-# documentation for details.
+# Place plugins here, each in their own subsection of [plugins].
+# See http://docs.mediagoblin.org/siteadmin/plugins.html for details.
 [plugins]
 [[mediagoblin.plugins.geolocation]]
 [[mediagoblin.plugins.basic_auth]]
