thunderbird-patch-review

Simple email patch review tool for Thunderbird

commit d81007a11e31f5b06e2de0d2f877b56a7ef7f382
parent 8c3ace1acc3de00047c3dc5428ef6af67357799a
Author: Marc <marc@coquand.email>
Date:   Sun, 19 Jul 2026 17:54:52 +0200

*

Diffstat:
M
README.html
 | 
66
++++++++++++++++++++++++++++++++++--------------------------------

1 file changed, 34 insertions(+), 32 deletions(-)
diff --git a/README.html b/README.html
@@ -1,11 +1,12 @@
-  <h1>Thunderbird Patch Review</h1>
-  <p>Review git patches from email inside Thunderbird</p>
-  <h2>Synopsis</h2>
-  <p>A Thunderbird Add-on. Open a patch email, press Review, comment
+<dl>
+  <dt>Thunderbird Patch Review</dt>
+  <dd>Review git patches from email inside Thunderbird</dd>
+  <dt>Synopsis</dt>
+  <dd>A Thunderbird Add-on. Open a patch email, press Review, comment
   on hunks, send the review as a mailing-list reply, and apply the
-  series to a local repository with git-am(1).</p>
+  series to a local repository with git-am(1).</dd>
 
-  <h2>Screenshots</h2>
+  <dt>Screenshots</dt>
   <figure>
     <figcaption>Fig: Patch button included in plugin</figcaption>
     <img style="max-width: 100%" src="/assets/patch-button.png" />
@@ -31,16 +32,16 @@
     <img style="max-width: 100%" src="/assets/srht-integration-thunderbird.png"/>
   </figure>
 
-  <h2>Installation (source)</h2>
-  <p>Package the extension source code as an .xpi and install it via
+  <dt>Installation (source)</dt>
+  <dd>Package the extension source code as an .xpi and install it via
   the Add-ons Manager gear menu (Install Add-on From File...). To
-  package it, run the following from the project root:</p>
+  package it, run the following from the project root:</dd>
   <pre><code>(cd extension && zip -qrX ../patch-review.xpi .)</code></pre>
 
-  <p>At some point I will upload the add-on to Thunderbird.</p>
+  <dd>At some point I will upload the add-on to Thunderbird.</dd>
 
-  <h2>Configuration</h2>
-  <p>Open the extension's preferences:</p>
+  <dt>Configuration</dt>
+  <dd>Open the extension's preferences:</dd>
   <dl>
     <dt>Editor command</dt>
     <dd><p>Run from the repository after a successful apply, with the
@@ -91,37 +92,38 @@
     <dd><p>Opens the review tab and removes it after a successful
     send.</p></dd>
   </dl>
-  <p>The privileged Apply, Browse... , and Open editor code does not use
+  <dd>The privileged Apply, Browse... , and Open editor code does not use
   a Mozilla permission: it is a WebExtension Experiment
   (<code>experiment_apis.patchHost</code>) shipped inside the XPI and
-  runs only when the extension is loaded.</p>
+  runs only when the extension is loaded.</dd>
 
-  <h2>Sourcehut integration</h2>
-  <p>When the series arrives via a sourcehut mailing list, an option
-  to set the patch state header will appear when sending the review. It uses <a href="https://man.sr.ht/lists.sr.ht/#email-controls">Sourcehut's email controls</a>.</p>
+  <dt>Sourcehut integration</dt>
+  <dd>When the series arrives via a sourcehut mailing list, an option
+  to set the patch state header will appear when sending the review. It uses <a href="https://man.sr.ht/lists.sr.ht/#email-controls">Sourcehut's email controls</a>.</dd>
 
-  <h2>Caveats</h2>
-  <p>Patches arriving as attachments, HTML-only mail, and reviewing
+  <dt>Caveats</dt>
+  <dd>Patches arriving as attachments, HTML-only mail, and reviewing
   from a git worktree preview are not supported yet. Series collection
-  searches the folder of the opened message only.</p>
+  searches the folder of the opened message only.</dd>
 
-  <h2>See also</h2>
-  <p><a href="https://mccd.space/posts/26-07-18/3-patch-review-tool-for-thunderbird">The introductory post</a> contains a small snippet with motivation.</p>
+  <dt>See also</dt>
+  <dd><a href="https://mccd.space/posts/26-07-18/3-patch-review-tool-for-thunderbird">The introductory post</a> contains a small snippet with motivation.</dd>
 
-  <h2>Disclaimer</h2>
-  <p>This add-on was vibe coded using GLM5.2 and built to solve the
+  <dt>Disclaimer</dt>
+  <dd>This add-on was vibe coded using GLM5.2 and built to solve the
   needs of my team. I was hesitant to share it, as I generally do not
   like vibe-coded projects. However, given that a tool like this is
-  sorely lacking from the ecosystem, I decided to share it anyway.</p>
+  sorely lacking from the ecosystem, I decided to share it anyway.</dd>
 
-  <p>I have not reviewed the code line-by-line, but I designed the
+  <dd>I have not reviewed the code line-by-line, but I designed the
     general approach the system should use, and focused on using as
     few dependencies as possible. I have also extensively Q&Ad the
-    plugin manually alongside the test suite.</p>
+    plugin manually alongside the test suite.</dd>
 
-  <h2>Contributing</h2>
-  <p>Contributions and bug reports go to the mailing list:
-    <a href="mailto:~marcc/thunderbird-review-plugin@lists.sr.ht">~marcc/thunderbird-review-plugin@lists.sr.ht</a>.</p>
+  <dt>Contributing</dt>
+  <dd>Contributions and bug reports go to the mailing list:
+    <a href="mailto:~marcc/thunderbird-review-plugin@lists.sr.ht">~marcc/thunderbird-review-plugin@lists.sr.ht</a>.</dd>
 
-  <h2>Author</h2>
-  <p>Marc Coquand<br>
+  <dt>Author</dt>
+  <dd>Marc Coquand</dd>
+</dl>