diff --git a/core/testcase.php b/core/testcase.php
index 458ec870..80390104 100644
--- a/core/testcase.php
+++ b/core/testcase.php
@@ -12,6 +12,9 @@ if(class_exists("\\PHPUnit\\Framework\\TestCase")) {
         protected static string $user_name = "test";
         protected string $wipe_time = "test";
 
+        /**
+         * Start a DB transaction for each test class
+         */
         public static function setUpBeforeClass(): void
         {
             global $_tracer, $database;
@@ -20,6 +23,9 @@ if(class_exists("\\PHPUnit\\Framework\\TestCase")) {
             parent::setUpBeforeClass();
         }
 
+        /**
+         * Start a savepoint for each test
+         */
         public function setUp(): void
         {
             global $database, $_tracer;
diff --git a/tests/bootstrap.php b/tests/bootstrap.php
index ab1a7f8c..32fc0ea1 100644
--- a/tests/bootstrap.php
+++ b/tests/bootstrap.php
@@ -1,5 +1,12 @@
 <?php
-
+/**
+ * Sets up a base test environment:
+ * - Loads the code
+ * - Runs the installer
+ * - Runs the database upgrade
+ * - Creates test users
+ * - Commits the database transaction
+ */
 declare(strict_types=1);
 
 namespace Shimmie2;