Where do you find hooks? How do you add them? An explaination!

This commit about talking to community members sponsored by
community member Aeva Palecek.  Thanks!

diff --git a/docs/source/pluginwriter/api.rst b/docs/source/pluginwriter/api.rst
index 819fac2d7845e0568044d2b60a02fe9026ef098a..33bb70c4fa10e96c0918e2508c3caf06ebe18713 100644 (file)
--- a/docs/source/pluginwriter/api.rst
+++ b/docs/source/pluginwriter/api.rst
@@ -26,6 +26,26 @@ moving target for a few releases.
 
 Please check the :ref:`release-notes` for updates!
 
+
+How are hooks added?  Where do I find them?
+-------------------------------------------
+
+Much of this document talks about hooks, both as in terms of regular
+hooks and template hooks.  But where do they come from, and how can
+you find a list of them?
+
+For the moment, the best way to find available hooks is to check the
+source code itself.  (Yes, we should start a more official hook
+listing with descriptions soon.)  But many hooks you may need do not
+exist yet: what to do then?
+
+The plan at present is that we are adding hooks as people need them,
+with community discussion.  If you find that you need a hook and
+MediaGoblin at present doesn't provide it at present, please
+`http://mediagoblin.org/pages/join.html <talk to us>`_!  We'll
+evaluate what to do from there.
+
+
 :mod:`pluginapi` Module
 -----------------------