Fied some documentation

git-svn-id: file:///humgen/gsa-scr1/gsa-engineering/svn_contents/trunk@406 348d0f76-0448-11de-a6fe-93d51630548a

java/test/org/broadinstitute/sting/BaseTest.java

@@ -33,7 +33,8 @@ import java.util.Enumeration;
  * <p/>
  * Class BaseTest
  * <p/>
- * A descriptions should go here. Blame aaron if it's missing.
+ * This is the base test class for all of our test cases.  All test cases should extend from this
+ * class, since it sets up the logger, and resolves any data directories that we rely on.
  */
 public abstract class BaseTest {
     /** our log, which we want to capture anything from org.broadinstitute.sting */

java/test/org/broadinstitute/sting/gatk/dataSources/shards/ShardStrategyFactoryTest.java

@@ -36,7 +36,9 @@ import java.util.ArrayList;
  * <p/>
  * Class ShardFactoryTest
  * <p/>
- * A descriptions should go here. Blame aaron if it's missing.
+ * Tests the shard strategy factory.  This tests the whole sharding interface, and should be
+ * split in the future into seperate test cases.
+ * TODO: split out for the seperate sharding classes
  */
 public class ShardStrategyFactoryTest extends BaseTest {
 

java/test/org/broadinstitute/sting/gatk/dataSources/simpleDataSources/SAMBAMDataSourceTest.java

@@ -41,7 +41,7 @@ import java.util.List;
  * <p/>
  * Class SAMBAMDataSourceTest
  * <p/>
- * A descriptions should go here. Blame aaron if it's missing.
+ * The test of the SAMBAM simple data source.
  */
 public class SAMBAMDataSourceTest extends BaseTest {