Improve markup of enumeration tables (#631)

see also w3c/media-source#307 (comment)
w3c · May 17, 2022 · c78394f · c78394f
1 parent 91e1299
commit c78394f
Showing 1 changed file with 22 additions and 18 deletions.
diff --git a/webrtc-stats.html b/webrtc-stats.html
@@ -918,12 +918,13 @@ <h3>
     "decode",
 };</pre>
             <table data-link-for="RTCCodecType" data-dfn-for="RTCCodecType" class="simple">
-              <tbody>
+	      <caption>{{RTCCodecType}} Enumeration description</caption>
+              <thead>
                 <tr>
-                  <th colspan="2">
-                    Enumeration description
-                  </th>
+		  <th>Enum value</th><th>Description</th>
                 </tr>
+	      </thead>
+	      <tbody>
                 <tr>
                   <td>
                     <dfn>encode</dfn>
@@ -2538,13 +2539,14 @@ <h3>
             "other",
           };</pre>
           <table data-link-for="RTCQualityLimitationReason" data-dfn-for=
-          "RTCQualityLimitationReason" class="simple">
-            <tbody>
+		 "RTCQualityLimitationReason" class="simple">
+	    <caption>{{RTCQualityLimitationReason}} Enumeration description</caption>
+            <thead>
               <tr>
-                <th colspan="2">
-                  Enumeration description
-                </th>
+		<th>Enum value</th><th>Description</th>
               </tr>
+	    </thead>
+	    <tbody>
               <tr>
                 <td>
                   <dfn>none</dfn>
@@ -3744,12 +3746,13 @@ <h3>
         "unknown",
 };</pre>
                 <table data-link-for="RTCDtlsRole" data-dfn-for="RTCDtlsRole" class="simple">
-                  <tbody>
+		  <caption>{{RTCDtlsRole}} Enumeration description</caption>
+                  <thead>
                     <tr>
-                      <th colspan="2">
-                        Enumeration description
-                      </th>
+		      <th>Enum value</th><th>Description</th>
                     </tr>
+		  </thead>
+		  <tbody>
                     <tr>
                       <td>
                         <dfn>client</dfn>
@@ -4416,13 +4419,14 @@ <h3>
     "succeeded"
 };</pre>
             <table data-link-for="RTCStatsIceCandidatePairState" data-dfn-for=
-            "RTCStatsIceCandidatePairState" class="simple">
-              <tbody>
+		   "RTCStatsIceCandidatePairState" class="simple">
+	      <caption>{{RTCStatsIceCandidatePairState}} Enumeration description</caption>
+              <thead>
                 <tr>
-                  <th colspan="2">
-                    Enumeration description
-                  </th>
+		  <th>Enum value</th><th>Description</th>
                 </tr>
+	      </thead>
+	      <tbody>
                 <tr>
                   <td>
                     <dfn>frozen</dfn>