diff --git a/log.go b/log.go
index 9810b6b61..cb00b7798 100644
--- a/log.go
+++ b/log.go
@@ -1,6 +1,12 @@
 package migrate
 
+// Logger is an interface so you can pass in your own
+// logging implementation.
 type Logger interface {
+
+	// Printf is like fmt.Printf
 	Printf(format string, v ...interface{})
+
+	// Verbose should return true when verbose logging output is wanted
 	Verbose() bool
 }
diff --git a/migrate_test.go b/migrate_test.go
index 1b5356895..8dcfda002 100644
--- a/migrate_test.go
+++ b/migrate_test.go
@@ -14,10 +14,10 @@ import (
 	sStub "github.com/mattes/migrate/source/stub"
 )
 
+// sourceStubMigrations hold the following migrations:
 // u = up migration, d = down migration, n = version
 //  |  1  |  -  |  3  |  4  |  5  |  -  |  7  |
 //  | u d |  -  | u   | u d |   d |  -  | u d |
-
 var sourceStubMigrations *source.Migrations
 
 func init() {