diff --git a/slides_template/README.ltx-talk b/slides_template/README.ltx-talk
index 28403b8..203afa4 100644
--- a/slides_template/README.ltx-talk
+++ b/slides_template/README.ltx-talk
@@ -98,10 +98,21 @@ Upstream: https://github.com/mrc-pop/trantor
 === Known gaps =================
 ================================
 
-Frame titles are not headings. ltx-talk's role map declares
-frametitle -> H4, but no such elements are emitted, so the tag tree has
-sections but no per-slide headings. The manual calls the relationship
-between frame titles and sectioning "still very much open".
+Frame titles must be given as \frametitle{...} inside the frame, not as
+the argument to \begin{frame}{...}. Only the command form is tagged; the
+argument form produces a frame with no heading at all, silently. This
+looks like an upstream oversight rather than a decision, so it may change.
+
+ltx-talk tags frame titles at H4, deliberately well below sections and
+subsections, and the manual describes the relationship between frame
+titles and sectioning as "still very much open". That default is left
+alone here. It can be changed with
+
+  \tagpdfsetup{role/new-tag = frametitle/H1}
+
+but H1 would put frame titles at the same level as the section headings
+that contain them, so it is worth deciding what an accessibility checker
+should see before reaching for it.
 
 Overlay tagging has an open upstream bug, issue #33, where \only<1> and
 \only<2> produce output that fails validation. The \pause and <+-> forms
diff --git a/slides_template/example.tex b/slides_template/example.tex
index 7845af5..5a60ea2 100644
--- a/slides_template/example.tex
+++ b/slides_template/example.tex
@@ -53,7 +53,8 @@
 \section{Introduction}
 \sectionpage
 
-\begin{frame}{A sample slide}
+\begin{frame}
+  \frametitle{A sample slide}
   A displayed formula:
   \[ \int_{-\infty}^\infty e^{-x^2} \, dx = \sqrt{\pi} \]
 
@@ -71,7 +72,8 @@
   \note<3->{Once the whole list is up, tie it back to the opening claim.}
 \end{frame}
 
-\begin{frame}{Short frame title}
+\begin{frame}
+  \frametitle{Short frame title}
   \e{A first} paragraph with \texttt{monospace text}.
 
   And then \e{a second} paragraph.