From f0117ec3dfcafbe554d020e38ebbe2005c35cdb4 Mon Sep 17 00:00:00 2001
From: Eric Huss <eric@huss.org>
Date: Wed, 5 Nov 2025 11:45:46 -0800
Subject: [PATCH] Add a comment about synchronizing the event stack

---
 crates/mdbook-html/src/html/tree.rs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/crates/mdbook-html/src/html/tree.rs b/crates/mdbook-html/src/html/tree.rs
index 4e1d8f35..432cf7be 100644
--- a/crates/mdbook-html/src/html/tree.rs
+++ b/crates/mdbook-html/src/html/tree.rs
@@ -307,6 +307,8 @@ where
             match event {
                 Event::Start(tag) => self.start_tag(tag),
                 Event::End(tag) => {
+                    // TODO: This should validate that the event stack is
+                    // properly synchronized with the tag stack.
                     self.pop();
                     match tag {
                         TagEnd::TableHead => {