Documenting the test_modify_context and context_modified_app methods

[mediagoblin.git] / docs / source / pluginwriter / api.rst

diff --git a/docs/source/pluginwriter/api.rst b/docs/source/pluginwriter/api.rst
index 3a75d455611f6120b7a83442725875b3a0cef975..df93351142710b9fdd1fcc69dccca3a57a36b3b5 100644 (file)
--- a/docs/source/pluginwriter/api.rst
+++ b/docs/source/pluginwriter/api.rst
@@ -31,4 +31,20 @@ Please check the release notes for updates!
 .. automodule:: mediagoblin.tools.pluginapi
    :members: get_config, register_routes, register_template_path,
              register_template_hooks, get_hook_templates,
-             hook_handle, hook_runall, hook_transform,
+             hook_handle, hook_runall, hook_transform
+
+Configuration
+-------------
+
+Your plugin may define its own configuration defaults.
+
+Simply add to the directory of your plugin a config_spec.ini file.  An
+example might look like::
+
+  [plugin_spec]
+  some_string = string(default="blork")
+  some_int = integer(default=50)
+
+This means that when people enable your plugin in their config you'll
+be able to provide defaults as well as type validation.
+