--- java/trunk/conditions/src/main/java/org/hps/conditions/package-info.java	2014-03-20 20:49:11 UTC (rev 326)
+++ java/trunk/conditions/src/main/java/org/hps/conditions/package-info.java	2014-03-20 20:49:39 UTC (rev 327)
@@ -7,6 +7,29 @@

  * </p>
  * 
  * <p>

+ * There is a chain of readers that is called by the manager which looks like:
+ * </p>
+ * 
+ * <p>
+ * DetectorConditionsReader => DatabaseConditionsReader => ConditionsReader
+ * </p>
+ * 
+ * <p>
+ * The {@link DetectorConditionsReader} extends the {@link DatabaseConditionsReader} and 
+ * handles compact.xml files or other files embedded as jar resources in the detector directories 
+ * (e.g. from detector-data).  It is the first class which attempts to resolve conditions by 
+ * name and type.  When it does not find a set of condition data, it will call its
+ * super class's method, which will then attempt to find the data.
+ * </p>
+ * 
+ * <p>
+ * The {@link DatabaseConditionsReader} in fact mostly relies on built-in behavior of the 
+ * {@link org.lcsim.conditions.ConditionsReader} class, which has a set of converters
+ * registered on it.  These converters perform the translation from database table rows
+ * to Java objects.
+ * </p>
+ * 
+ * <p>