From 6c1b9958c45db269b2dcdcbd68f71e10f0356d1c Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Sun, 26 May 2024 16:53:36 +0200
Subject: [PATCH] doc: add section about kernel booted once

---
 doc/caveats.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/caveats.md b/doc/caveats.md
index d2ab5648..24cdb40d 100644
--- a/doc/caveats.md
+++ b/doc/caveats.md
@@ -59,3 +59,11 @@ when@test:
     framework:
         test: true
 ```
+
+## LogicException: […] the kernel should only be booted once.
+
+Complete error message:
+
+> LogicException: Booting the kernel before calling "Symfony\Bundle\FrameworkBundle\Test\WebTestCase::createClient()" is not supported, the kernel should only be booted once.
+
+Solution: Call `self::ensureKernelShutdown();` before creating the client.