From 59cbf667877f91412f5399b7a636c2b54c927203 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?David=20R=C3=B6nnqvist?= <ronnqvist@apple.com>
Date: Thu, 11 Dec 2025 11:59:33 +0100
Subject: [PATCH] Make a tiny simplification to the parameters HTML output

---
 .../MarkdownRenderer+Parameters.swift         |  8 +---
 .../MarkdownRenderer+PageElementsTests.swift  | 44 +++++--------------
 2 files changed, 13 insertions(+), 39 deletions(-)

diff --git a/Sources/DocCHTML/MarkdownRenderer+Parameters.swift b/Sources/DocCHTML/MarkdownRenderer+Parameters.swift
index a316f6e49..45a43589f 100644
--- a/Sources/DocCHTML/MarkdownRenderer+Parameters.swift
+++ b/Sources/DocCHTML/MarkdownRenderer+Parameters.swift
@@ -78,9 +78,7 @@ package extension MarkdownRenderer {
         for parameter in parameterInfo {
             // name
             items.append(
-                .element(named: "dt", children: [
-                    .element(named: "code", children: [.text(parameter.name)])
-                ])
+                .element(named: "dt", children: [.text(parameter.name)])
             )
             // description
             items.append(
@@ -131,9 +129,7 @@ package extension MarkdownRenderer {
             let index = (offset + primaryOnlyIndices.count(where: { $0 < offset })) * 2
             items.insert(contentsOf: [
                 // Name
-                .element(named: "dt", children: [
-                    .element(named: "code", children: [.text(parameter.name)])
-                ], attributes: ["class": "\(secondary.language.id)-only"]),
+                .element(named: "dt", children: [.text(parameter.name)], attributes: ["class": "\(secondary.language.id)-only"]),
                 // Description
                 .element(named: "dd", children: parameter.content.map { visit($0) }, attributes: ["class": "\(secondary.language.id)-only"])
             ], at: index)
diff --git a/Tests/DocCHTMLTests/MarkdownRenderer+PageElementsTests.swift b/Tests/DocCHTMLTests/MarkdownRenderer+PageElementsTests.swift
index 199a88a9b..11ca447e2 100644
--- a/Tests/DocCHTMLTests/MarkdownRenderer+PageElementsTests.swift
+++ b/Tests/DocCHTMLTests/MarkdownRenderer+PageElementsTests.swift
@@ -131,17 +131,13 @@ struct MarkdownRenderer_PageElementsTests {
                 <a href="#Parameters">Parameters</a>
               </h2>
               <dl>
-                <dt>
-                  <code>First</code>
-                </dt>
+                <dt>First</dt>
                 <dd>
                   <p>
                     Some <i>formatted</i> description with <code>code</code>
                   </p>
                 </dd>
-                <dt>
-                  <code>Second</code>
-                </dt>
+                <dt>Second</dt>
                 <dd>
                   <p>
                     Some <b>other</b> <i>formatted</i> description</p>
@@ -154,16 +150,12 @@ struct MarkdownRenderer_PageElementsTests {
             parameters.assertMatches(prettyFormatted: true, expectedXMLString: """
             <h2>Parameters</h2>
             <dl>
-              <dt>
-                <code>First</code>
-              </dt>
+              <dt>First</dt>
               <dd>
                 <p>Some <i>formatted</i>description with <code>code</code>
                 </p>
               </dd>
-              <dt>
-                <code>Second</code>
-              </dt>
+              <dt>Second</dt>
               <dd>
                 <p>
                   Some <b>other</b> <i>formatted</i> description</p>
@@ -194,27 +186,19 @@ struct MarkdownRenderer_PageElementsTests {
             <a href="#Parameters">Parameters</a>
           </h2>
           <dl>
-            <dt>
-              <code>FirstCommon</code>
-            </dt>
+            <dt>FirstCommon</dt>
             <dd>
               <p>Available in both languages</p>
             </dd>
-            <dt class="swift-only">
-              <code>SwiftOnly</code>
-            </dt>
+            <dt class="swift-only">SwiftOnly</dt>
             <dd class="swift-only">
               <p>Only available in Swift</p>
             </dd>
-            <dt>
-              <code>SecondCommon</code>
-            </dt>
+            <dt>SecondCommon</dt>
             <dd>
               <p>Also available in both languages</p>
             </dd>
-            <dt class="occ-only">
-              <code>ObjectiveCOnly</code>
-            </dt>
+            <dt class="occ-only">ObjectiveCOnly</dt>
             <dd class="occ-only">
               <p>Only available in Objective-C</p>
             </dd>
@@ -242,25 +226,19 @@ struct MarkdownRenderer_PageElementsTests {
             <a href="#Parameters">Parameters</a>
           </h2>
           <dl class="swift-only">
-            <dt>
-              <code>First</code>
-            </dt>
+            <dt>First</dt>
             <dd>
               <p>Some description</p>
             </dd>
           </dl>
           <dl class="data-only">
-            <dt>
-              <code>Third</code>
-            </dt>
+            <dt>Third</dt>
             <dd>
               <p>Some description</p>
             </dd>
           </dl>
           <dl class="occ-only">
-            <dt>
-              <code>Second</code>
-            </dt>
+            <dt>Second</dt>
             <dd>
               <p>Some description</p>
             </dd>