diff --git a/java/test/org/broadinstitute/sting/BaseTest.java b/java/test/org/broadinstitute/sting/BaseTest.java
index a2ec6e9ca..5455c310a 100755
--- a/java/test/org/broadinstitute/sting/BaseTest.java
+++ b/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 */
diff --git a/java/test/org/broadinstitute/sting/gatk/dataSources/shards/ShardStrategyFactoryTest.java b/java/test/org/broadinstitute/sting/gatk/dataSources/shards/ShardStrategyFactoryTest.java
index 843c62aca..7b9f797eb 100755
--- a/java/test/org/broadinstitute/sting/gatk/dataSources/shards/ShardStrategyFactoryTest.java
+++ b/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 {
 
diff --git a/java/test/org/broadinstitute/sting/gatk/dataSources/simpleDataSources/SAMBAMDataSourceTest.java b/java/test/org/broadinstitute/sting/gatk/dataSources/simpleDataSources/SAMBAMDataSourceTest.java
index 2172b986a..2b3cef898 100755
--- a/java/test/org/broadinstitute/sting/gatk/dataSources/simpleDataSources/SAMBAMDataSourceTest.java
+++ b/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 {