add/fix some module-level docstrings

conftest.py

@@ -1,5 +1,5 @@
 """
-configuration for the tests
+configuration for the (py.test based) tests
 """
 
 import pytest

nsupdate/api/views.py

@@ -1,4 +1,7 @@
 # -*- coding: utf-8 -*-
+"""
+views for the (usually non-interactive, automated) web api
+"""
 
 import logging
 logger = logging.getLogger(__name__)

nsupdate/context_processors.py

@@ -1,4 +1,8 @@
 # -*- coding: utf-8 -*-
+"""
+context processors for injecting some settings into the template context and
+also for keeping the IP addrs in the session fresh.
+"""
 
 import logging
 logger = logging.getLogger(__name__)

nsupdate/main/admin.py

@@ -1,3 +1,7 @@
+"""
+register our models for Django's admin
+"""
+
 from django.contrib import admin
 
 from .models import Host, Domain, BlacklistedDomain, ServiceUpdater, ServiceUpdaterHostConfig

nsupdate/main/forms.py

@@ -1,4 +1,8 @@
 # -*- coding: utf-8 -*-
+"""
+form definitions (which fields are available, order, autofocus, ...)
+"""
+
 from django import forms
 
 from .models import Host, Domain, ServiceUpdaterHostConfig

nsupdate/main/models.py

@@ -1,3 +1,7 @@
+"""
+models for hosts, domains, service updaters, ...
+"""
+
 import re
 import base64
 

nsupdate/main/urls.py

@@ -1,3 +1,7 @@
+"""
+main app url dispatching
+"""
+
 from django.conf.urls import patterns, url
 from django.views.generic import TemplateView
 

nsupdate/main/views.py

@@ -1,4 +1,7 @@
 # -*- coding: utf-8 -*-
+"""
+views for the interactive web user interface
+"""
 
 from datetime import timedelta
 

nsupdate/management/commands/faults.py

@@ -1,5 +1,5 @@
 """
-reinitialize the test user account (and clean up)
+dealing with the fault counters and available/abuse/abuse_blocked flags
 """
 
 from optparse import make_option

nsupdate/urls.py

@@ -1,3 +1,7 @@
+"""
+top-level url dispatching
+"""
+
 from django.conf import settings
 from django.conf.urls import patterns, include, url
 from django.contrib import admin