aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/source/configuration.rst21
1 files changed, 19 insertions, 2 deletions
diff --git a/docs/source/configuration.rst b/docs/source/configuration.rst
index 93cc4a17..354a7098 100644
--- a/docs/source/configuration.rst
+++ b/docs/source/configuration.rst
@@ -19,8 +19,25 @@ mediagoblin.ini
tweak settings for MediaGoblin, you'll usually tweak them here.
paste.ini
-
-mediagoblin.ini
+ Primarily a server configuration file, on the python side
+ (specifically, on the wsgi side, via `paste deploy
+ <http://pythonpaste.org/deploy/>`_ / `paste script
+ <http://pythonpaste.org/script/>`_). It also sets up some
+ middleware that you can mostly ignore, except to configure
+ sessions... more on that later. If you are adding a different
+ python server other than fastcgi / plain http, you might configure
+ it here. Mostly you won't touch this file as much, probably.
+
+
+There's one more file that you certainly won't change unless you're
+making coding contributions to mediagoblin, but which can be useful to
+read and reference:
+
+mediagoblin/config_spec.ini
+ This file is actually a specification for mediagoblin.ini itself, as
+ a config file! It defines types and defaults. Sometimes it's a
+ good place to look for documentation... or to find out that hidden
+ option that we didn't tell you about. :)
Making local copies