--- a/degal/folder.py	Wed Jun 17 17:56:02 2009 +0300
+++ b/degal/folder.py	Wed Jun 17 18:08:49 2009 +0300
@@ -10,7 +10,12 @@
 
 class Folder (filesystem.Directory) :
     """
-        A Folder is a filesystem Directory that contains any number of other Folders and Images.
+        A Folder is a filesystem Directory that:
+            * has a title/description (XXX: Page)
+            * contains any number of other sub-Folders and Images.
+            * can load custom configuration for itself and sub-nodes to override the base config
+            * holds sub-dirs for previews/thumbs
+            * has a HTML view
     """
 
     def iter_config_files (self) :
@@ -32,8 +37,9 @@
 
                 break
 
-        # load some info from title?
+        # load some info for title?
         if self.config and self.config.title :
+            # override our default title
             self.title = self.config.title
 
             # disable it so it won't be used by children
@@ -43,7 +49,7 @@
     @lazy_load
     def title (self) :
         """
-            Find the title for this dir
+            Find the default title for this dir.
         """
 
         # default
@@ -61,7 +67,7 @@
     @lazy_load
     def preview_dir (self) :
         """
-            Load and return the Directory for previews
+            Load and return the Directory used for for preview Thumbnails
         """
         
         return self.subdir(self.config.preview_dir, create=True)
@@ -69,7 +75,7 @@
     @lazy_load
     def thumb_dir (self) :
         """
-            Load and return the Directory for thumbs
+            Load and return the Directory used for thumb Thumbnails
         """
         
         return self.subdir(self.config.thumb_dir, create=True)