Link common configuration options explicitly.

docs/service_template.html

@@ -15,6 +15,11 @@
     [my_issue_tracker]
     service = {{ service_name }}
 
+The above example is the minimum required to import issues from
+{{ service_name_humane }}.  You can also feel free to use any of the
+configuration options described in :ref:`common_configuration_options`
+or described in `Service Features`_ below.
+
 Service Features
 ----------------
 

docs/source/common_configuration.rst

@@ -26,6 +26,8 @@ Optional options include:
 
 A more-detailed example configuration can be found at :ref:`example_configuration`.
 
+.. _common_configuration_options:
+
 Common Service Configuration Options
 ------------------------------------
 

docs/source/services/activecollab.rst

@@ -45,6 +45,10 @@ see :ref:`activecollab2` for activeCollab2.x.
     activecollab.key = your-api-key
     activecollab.user_id = 15
 
+The above example is the minimum required to import issues from
+ActiveCollab 3.  You can also feel free to use any of the
+configuration options described in :ref:`common_configuration_options`.
+
 Provided UDA Fields
 -------------------
 

docs/source/services/activecollab2.rst

@@ -40,6 +40,10 @@ with ActiveCollab 2.x - see above for 3.x and greater.
     activecollab2.user_id = 15
     activecollab2.projects = 1:first_project, 5:another_project
 
+The above example is the minimum required to import issues from
+ActiveCollab 2.  You can also feel free to use any of the
+configuration options described in :ref:`common_configuration_options`.
+
 Provided UDA Fields
 -------------------
 

docs/source/services/bitbucket.rst

@@ -14,6 +14,9 @@ Here's an example of an Bitbucket target::
     bitbucket.username = ralphbean
     bitbucket.password = mypassword
 
+The above example is the minimum required to import issues from
+Bitbucket.  You can also feel free to use any of the
+configuration options described in :ref:`common_configuration_options`.
 
 Provided UDA Fields
 -------------------

docs/source/services/bugzilla.rst

@@ -26,6 +26,10 @@ make bugwarrior support more robust!
     bugzilla.username = rbean@redhat.com
     bugzilla.password = OMG_LULZ
 
+The above example is the minimum required to import issues from
+Bugzilla.  You can also feel free to use any of the
+configuration options described in :ref:`common_configuration_options`.
+
 Provided UDA Fields
 -------------------
 

docs/source/services/github.rst

@@ -14,6 +14,11 @@ Here's an example of an Github target::
     github.login = ralphbean
     github.password = OMG_LULZ
 
+The above example is the minimum required to import issues from
+Github.  You can also feel free to use any of the
+configuration options described in :ref:`common_configuration_options`
+or described in `Service Features`_ below.
+
 Service Features
 ----------------
 

docs/source/services/jira.rst

@@ -19,6 +19,11 @@ Here's an example of a jira project::
 
    The ``base_uri`` must not have a trailing slash.
 
+The above example is the minimum required to import issues from
+Jira.  You can also feel free to use any of the
+configuration options described in :ref:`common_configuration_options`
+or described in `Service Features`_ below.
+
 Service Features
 ----------------
 

docs/source/services/megaplan.rst

@@ -16,6 +16,10 @@ Here's an example of an Megaplan target::
     megaplan.password = secret
     megaplan.project_name = example
 
+The above example is the minimum required to import issues from
+Megaplab.  You can also feel free to use any of the
+configuration options described in :ref:`common_configuration_options`.
+
 Provided UDA Fields
 -------------------
 

docs/source/services/phabricator.rst

@@ -18,6 +18,10 @@ Here's an example of an Phabricator target::
    to gather information from Phabricator, 
    but credentials will be gathered from the user's ``~/.arcrc``.
 
+The above example is the minimum required to import issues from
+Phabricator.  You can also feel free to use any of the
+configuration options described in :ref:`common_configuration_options`.
+
 Provided UDA Fields
 -------------------
 

docs/source/services/redmine.rst

@@ -16,6 +16,10 @@ Here's an example of an Redmine target::
     redmine.user_id = 7
     redmine.project_name = redmine
 
+The above example is the minimum required to import issues from
+Redmine.  You can also feel free to use any of the
+configuration options described in :ref:`common_configuration_options`.
+
 Provided UDA Fields
 -------------------
 

docs/source/services/teamlab.rst

@@ -16,6 +16,10 @@ Here's an example of an Teamlab target::
     teamlab.password = secret
     teamlab.project_name = example_teamlab
 
+The above example is the minimum required to import issues from
+Teamlab.  You can also feel free to use any of the
+configuration options described in :ref:`common_configuration_options`.
+
 Provided UDA Fields
 -------------------
 

docs/source/services/trac.rst

@@ -20,6 +20,10 @@ Here's an example of an Trac target::
    Your Trac installation must have the XML-RPC plugin enabled
    for Bugwarrior to work.
 
+The above example is the minimum required to import issues from
+Trac.  You can also feel free to use any of the
+configuration options described in :ref:`common_configuration_options`.
+
 Service Features
 ----------------