allura git commit: [#7870] further comments in development.ini

[br...@apache.org]

Repository: allura
Updated Branches:
  refs/heads/db/7870 6c3372fa8 -> 4fb7540f9


[#7870] further comments in development.ini


Project: http://git-wip-us.apache.org/repos/asf/allura/repo
Commit: http://git-wip-us.apache.org/repos/asf/allura/commit/4fb7540f
Tree: http://git-wip-us.apache.org/repos/asf/allura/tree/4fb7540f
Diff: http://git-wip-us.apache.org/repos/asf/allura/diff/4fb7540f

Branch: refs/heads/db/7870
Commit: 4fb7540f9c4f37787334f40159cc107310236401
Parents: 6c3372f
Author: Dave Brondsema <da...@brondsema.net>
Authored: Mon Apr 20 12:11:46 2015 -0400
Committer: Dave Brondsema <da...@brondsema.net>
Committed: Mon Apr 20 12:11:46 2015 -0400

----------------------------------------------------------------------
 Allura/development.ini | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/allura/blob/4fb7540f/Allura/development.ini
----------------------------------------------------------------------
diff --git a/Allura/development.ini b/Allura/development.ini
index b7e0b95..5d68aed 100644
--- a/Allura/development.ini
+++ b/Allura/development.ini
@@ -77,7 +77,9 @@ full_stack = true
 site_name = Allura
 ; Change these to your website's domain
 domain = localhost
+; Change this to your website's full URL
 base_url = http://localhost:8080
+; This should be the same as base_url
 forgemail.url = http://localhost:8080
 
 ; Used to uniquify references to static resources, can be a timestamp or any unique value
@@ -111,7 +113,7 @@ beaker.session.validate_key = 714bfe3612c42390726f
 ; Google Analytics account for tracking
 ;ga.account = UA-XXXXX-X
 
-; Project registration system.  Only local is available, unless you write a custom one for custom integratino.
+; Project registration system.  Only local is available, unless you write a custom one for custom integration.
 registration.method = local
 theme = allura
 
@@ -123,6 +125,7 @@ auth.remember_for = 365  ; in days, for the "remember me" checkbox on login
 ; Customize login/logout URLs only if you have some custom authentication set up.
 auth.login_url = /auth/
 auth.logout_url = /auth/logout
+; the login fragement URL shows just the form, not a whole page.  It is used within a login overlay on some pages
 auth.login_fragment_url = /auth/login_fragment/
 auth.post_logout_url = /
 
@@ -367,6 +370,7 @@ ming.task.auto_ensure_indexes = False
 stats.sample_rate = 1
 
 ; Taskd setup
+; number of seconds to sleep between checking for new tasks
 monq.poll_interval=2
 
 ; SOLR setup
@@ -404,10 +408,13 @@ forgemail.domain = .in.localhost
 ; set this to "false" if you are deploying to production and want performance improvements
 auto_reload_templates = true
 
-; How frequently users can send messages
+; How frequently users can send messages, in seconds
 user_message.time_interval = 3600
+; Max number of messages that can be sent within that time interval.
 user_message.max_messages = 20
+
 ; Default number of times to show a sitewide notification
+; See https://forge-allura.apache.org/docs/getting_started/administration.html#site-notifications
 site_notification.impressions = 0
 
 ; When rendering discussion post Markdown to html, if the render takes longer
@@ -424,6 +431,7 @@ markdown_render_max_length = 999999999
 show_export_control = false
 
 ; By default project admins can soft-delete their projects.
+; A soft-deleted project will still be in the database and visible to admins, but not to others.
 allow_project_delete = true
 allow_project_undelete = true
 
@@ -483,7 +491,7 @@ override_root = task ; TurboGears will use controllers/task.py as root controlle
 ;
 ; Add additional loggers, handlers, formatters here
 ; Uses python's logging config file format
-; http://docs.python.org/lib/logging-config-fileformat.html
+; https://docs.python.org/2/library/logging.config.html#configuration-file-format
 ;
 [loggers]
 keys = root, allura, sqlalchemy, paste, pylons, taskdstatus, timermiddleware, tmw_details