diff --git a/test/next/jdbc/connection_test.clj b/test/next/jdbc/connection_test.clj
index bbd4ff1..93d6283 100644
--- a/test/next/jdbc/connection_test.clj
+++ b/test/next/jdbc/connection_test.clj
@@ -1,6 +1,11 @@
 ;; copyright (c) 2019 Sean Corfield, all rights reserved
 
 (ns next.jdbc.connection-test
+  "Tests for the main hash map spec to JDBC URL logic and the get-datasource
+  and get-connection protocol implementations.
+
+  At some point, the datasource/connection tests should probably be extended
+  to accept EDN specs from an external source (environment variables?)."
   (:require [clojure.string :as str]
             [clojure.test :refer [deftest is testing]]
             [next.jdbc.connection :as c]
diff --git a/test/next/jdbc/prepare_test.clj b/test/next/jdbc/prepare_test.clj
index 047f52f..daa6850 100644
--- a/test/next/jdbc/prepare_test.clj
+++ b/test/next/jdbc/prepare_test.clj
@@ -1,5 +1,11 @@
 ;; copyright (c) 2019 Sean Corfield, all rights reserved
 
 (ns next.jdbc.prepare-test
+  "Stub test namespace for PreparedStatement creation etc.
+
+  This functionality is core to all of the higher-level stuff so it mostly
+  gets tested that way, but there should be some dedicated tests in here
+  eventually that ensure all of the options specific to PreparedStatement
+  actually work they way they're supposed to!"
   (:require [clojure.test :refer [deftest is testing]]
             [next.jdbc.prepare :refer :all]))
diff --git a/test/next/jdbc/protocols_test.clj b/test/next/jdbc/protocols_test.clj
index 332a126..b177726 100644
--- a/test/next/jdbc/protocols_test.clj
+++ b/test/next/jdbc/protocols_test.clj
@@ -1,5 +1,7 @@
 ;; copyright (c) 2019 Sean Corfield, all rights reserved
 
 (ns next.jdbc.protocols-test
+  "Stub test namespace for low-level protocols. Nothing can really be tested
+  at this level tho'..."
   (:require [clojure.test :refer [deftest is testing]]
             [next.jdbc.protocols :refer :all]))
diff --git a/test/next/jdbc/quoted_test.clj b/test/next/jdbc/quoted_test.clj
index eaef813..8d6a6a5 100644
--- a/test/next/jdbc/quoted_test.clj
+++ b/test/next/jdbc/quoted_test.clj
@@ -1,6 +1,8 @@
 ;; copyright (c) 2019 Sean Corfield, all rights reserved
 
 (ns next.jdbc.quoted-test
+  "Basic tests for quoting strategies. These are also tested indirectly
+  via the next.jdbc.sql tests."
   (:require [clojure.test :refer [deftest are]]
             [next.jdbc.quoted :refer :all]))
 
diff --git a/test/next/jdbc/result_set_test.clj b/test/next/jdbc/result_set_test.clj
index 831b119..6fea93f 100644
--- a/test/next/jdbc/result_set_test.clj
+++ b/test/next/jdbc/result_set_test.clj
@@ -1,5 +1,14 @@
 ;; copyright (c) 2019 Sean Corfield, all rights reserved
 
 (ns next.jdbc.result-set-test
+  "Stub test namespace for the result set functions.
+
+  There's so much that should be tested here:
+  * column name generation functions
+  * ReadableColumn protocol extension point
+  * RowBuilder and ResultSetBuilder machinery
+  * datafy/nav support
+  * ResultSet-as-map for reducible! / -execute protocol
+  * -execute-one and -execute-all implementations"
   (:require [clojure.test :refer [deftest is testing]]
             [next.jdbc.result-set :refer :all]))
diff --git a/test/next/jdbc/transaction_test.clj b/test/next/jdbc/transaction_test.clj
index 441c7fe..96b8395 100644
--- a/test/next/jdbc/transaction_test.clj
+++ b/test/next/jdbc/transaction_test.clj
@@ -1,5 +1,6 @@
 ;; copyright (c) 2019 Sean Corfield, all rights reserved
 
 (ns next.jdbc.transaction-test
+  "Stub test namespace for transaction handling."
   (:require [clojure.test :refer [deftest is testing]]
             [next.jdbc.transaction :refer :all]))