Docstrings for all modules

core/views/caves.py

@@ -15,13 +15,18 @@ from django.shortcuts import get_object_or_404, render
 from django.core.exceptions import ObjectDoesNotExist, MultipleObjectsReturned
 
 import troggle.settings as settings
-#import troggle.core.models as models
 from troggle.core.views import expo
 from troggle.core.models.troggle import Expedition, DataIssue
 from troggle.core.models.caves import CaveSlug, Cave, CaveAndEntrance, QM, EntranceSlug, Entrance, Area, SurvexStation, GetCaveLookup
 from troggle.core.forms import CaveForm, CaveAndEntranceFormSet, VersionControlCommentForm, EntranceForm, EntranceLetterForm
 from .login import login_required_if_public
 
+'''Manages the complex procedures to assemble a cave description out of the compnoents
+Manages the use of cavern to parse survex files to produce 3d and pos files
+
+Also generates the prospecting guide document.
+'''
+
 class MapLocations(object):
     p = [
         ("laser.0_7", "BNase", "Reference", "Bräuning Nase laser point"),

core/views/statistics.py

@@ -17,6 +17,9 @@ from troggle.core.models.survex import SurvexBlock
 
 import troggle.settings as settings
 
+'''Very simple report pages summarizing data about the whole set of expeditions and of
+the status of data inconsistencies
+'''
 
 def pathsreport(request):
     pathsdict = OrderedDict()

core/views/survex.py

@@ -19,6 +19,10 @@ from troggle.core.models.survex import SurvexBlock, SurvexPersonRole, SurvexFile
 from troggle.core.models.caves import Cave, PersonTrip, LogbookEntry
 from troggle.parsers.people import GetPersonExpeditionNameLookup
 
+'''Everything that views survexfiles 
+but also displays data on a cave or caves when there is ambiguity
+'''
+
 survexdatasetpath = Path(settings.SURVEX_DATA)
 
 survextemplatefile = """; *** THIS IS A TEMPLATE FILE NOT WHAT YOU MIGHT BE EXPECTING ***