added documentation explaining why we're loading lens

letsencrypt-apache/letsencrypt_apache/augeas_configurator.py

@@ -1,6 +1,5 @@
 """Class of Augeas Configurators."""
 import logging
-import os
 
 import augeas
 
@@ -31,6 +30,7 @@ class AugeasConfigurator(common.Plugin):
         super(AugeasConfigurator, self).__init__(*args, **kwargs)
 
         self.aug = augeas.Augeas(
+            # specify a directory to load our preferred lens from
             loadpath=constants.AUGEAS_LENS_DIR,
             # Do not save backup (we do it ourselves), do not load
             # anything by default

letsencrypt-apache/letsencrypt_apache/augeas_lens/README

@@ -0,0 +1,2 @@
+Let's Encrypt includes the very latest Augeas lenses in order to ship bug fixes 
+to Apacche configuration handling bugs as quickly as possible