lucifer: Clean up

Final clean up now that design is stable.

Mostly documentation changes with some refactoring.

BUG=chromium:748234
TEST=bin/test_lucifer

Change-Id: I55c3ad1792e5aeeb98f0d205474b166021049c43
Reviewed-on: https://chromium-review.googlesource.com/714645
Commit-Ready: Allen Li <ayatane@chromium.org>
Tested-by: Allen Li <ayatane@chromium.org>
Reviewed-by: Prathmesh Prabhu <pprabhu@chromium.org>
diff --git a/venv/lucifer/autotest.py b/venv/lucifer/autotest.py
index 25095ff..8ca1882 100644
--- a/venv/lucifer/autotest.py
+++ b/venv/lucifer/autotest.py
@@ -33,17 +33,13 @@
 def monkeypatch():
     """Do necessary Autotest monkeypatching.
 
-    This should be called before any autotest_lib imports in the main
-    function in scripts.  Thus, only the main function in scripts can
-    import autotest_lib.
-
-    Library code should rely on dependency injection, falling back to
-    load().
+    This should be called before any calls to load().  Only the main
+    function in scripts should call this function.
 
     This should be called no more than once.
 
-    This adds Autotest's site-packages and modifies sys.meta_path so
-    that all common.py imports are no-ops.
+    This adds Autotest's site-packages to the import path and modifies
+    sys.meta_path so that all common.py imports are no-ops.
     """
     global _setup_done
     assert not _setup_done
@@ -89,9 +85,7 @@
 def load(name):
     """Import module from autotest.
 
-    This enforces that monkeypatch() is called first.  Otherwise,
-    autotest imports may or may not work.  When they do work, they may
-    screw up global state.
+    This enforces that monkeypatch() is called first.
 
     @param name: name of module as string, e.g., 'frontend.afe.models'
     """