From 1a3707fa39757179cd7085ca6411ba08c366d2fb Mon Sep 17 00:00:00 2001
From: Dominique Hazael-Massieux <dom@w3.org>
Date: Thu, 28 Apr 2022 14:45:19 +0200
Subject: [PATCH] Improve markup of enumeration tables

see also https://github.com/w3c/media-source/issues/307#issuecomment-1110865467
---
 webrtc.html | 145 ++++++++++++++++++++++------------------------------
 1 file changed, 62 insertions(+), 83 deletions(-)

diff --git a/webrtc.html b/webrtc.html
index ef931f1f1..f3f1e1df0 100644
--- a/webrtc.html
+++ b/webrtc.html
@@ -400,13 +400,12 @@ <h4>
   "password"
 };</pre>
             <table data-link-for="RTCIceCredentialType" data-dfn-for=
-            "RTCIceCredentialType" class="simple">
+		   "RTCIceCredentialType" class="simple">
+	      <caption>{{RTCIceCredentialType}} Enumeration description</caption>
               <thead>
                 <tr>
-                  <th colspan="2">
-                    Enumeration description
-                  </th>
-                </tr>
+		  <th>Enum value</th><th>Description</th>
+		</tr>
               </thead>
               <tbody>
                 <tr>
@@ -536,12 +535,11 @@ <h4>
 };</pre>
             <table data-link-for="RTCIceTransportPolicy" data-dfn-for=
             "RTCIceTransportPolicy" class="simple">
+	      <caption>{{RTCIceTransportPolicy}} Enumeration description</caption>
               <thead>
                 <tr>
-                  <th colspan="2">
-                    Enumeration description (non-normative)
-                  </th>
-                </tr>
+		  <th>Enum value</th><th>Description</th>
+		</tr>
               </thead>
               <tbody>
                 <tr>
@@ -603,12 +601,11 @@ <h4>
 };</pre>
             <table data-link-for="RTCBundlePolicy" data-dfn-for=
             "RTCBundlePolicy" class="simple">
+	      <caption>{{RTCBundlePolicy}} Enumeration description</caption>
               <thead>
                 <tr>
-                  <th colspan="2">
-                    Enumeration description (non-normative)
-                  </th>
-                </tr>
+		  <th>Enum value</th><th>Description</th>
+		</tr>
               </thead>
               <tbody>
                 <tr>
@@ -667,12 +664,11 @@ <h4>
             </pre>
             <table data-link-for="RTCRtcpMuxPolicy" data-dfn-for=
             "RTCRtcpMuxPolicy" class="simple">
+	      <caption>{{RTCRtcpMuxPolicy}} Enumeration description</caption>
               <thead>
                 <tr>
-                  <th colspan="2">
-                    Enumeration description (non-normative)
-                  </th>
-                </tr>
+		  <th>Enum value</th><th>Description</th>
+		</tr>
               </thead>
               <tbody>
                 <tr>
@@ -789,13 +785,12 @@ <h4>
   "closed"
 };</pre>
             <table data-link-for="RTCSignalingState" data-dfn-for=
-            "RTCSignalingState" class="simple">
+		   "RTCSignalingState" class="simple">
+	      <caption>{{RTCSignalingState}} Enumeration description</caption>
               <thead>
                 <tr>
-                  <th colspan="2">
-                    Enumeration description
-                  </th>
-                </tr>
+		  <th>Enum value</th><th>Description</th>
+		</tr>
               </thead>
               <tbody>
                 <tr>
@@ -925,12 +920,11 @@ <h4>
 };</pre>
             <table data-link-for="RTCIceGatheringState" data-dfn-for=
             "RTCIceGatheringState" class="simple">
+	      <caption>{{RTCIceGatheringState}} Enumeration description</caption>
               <thead>
                 <tr>
-                  <th colspan="2">
-                    Enumeration description
-                  </th>
-                </tr>
+		  <th>Enum value</th><th>Description</th>
+		</tr>
               </thead>
               <tbody>
                 <tr>
@@ -990,13 +984,12 @@ <h4>
   "connected"
 };</pre>
             <table data-link-for="RTCPeerConnectionState" data-dfn-for=
-            "RTCPeerConnectionState" class="simple">
+		   "RTCPeerConnectionState" class="simple">
+	      <caption>{{RTCPeerConnectionState}} Enumeration description</caption>
               <thead>
                 <tr>
-                  <th colspan="2">
-                    Enumeration description
-                  </th>
-                </tr>
+		  <th>Enum value</th><th>Description</th>
+		</tr>
               </thead>
               <tbody>
                 <tr>
@@ -1103,12 +1096,11 @@ <h4>
 };</pre>
             <table data-link-for="RTCIceConnectionState" data-dfn-for=
             "RTCIceConnectionState" class="simple">
+	      <caption>{{RTCIceConnectionState}} Enumeration description</caption>
               <thead>
                 <tr>
-                  <th colspan="2">
-                    Enumeration description
-                  </th>
-                </tr>
+		  <th>Enum value</th><th>Description</th>
+		</tr>
               </thead>
               <tbody>
                 <tr>
@@ -5467,12 +5459,11 @@ <h4>
   "rollback"
 };</pre>
             <table data-link-for="RTCSdpType" data-dfn-for="RTCSdpType" class=
-            "simple">
+		   "simple">
+	      <caption>{{RTCSdpType}} Enumeration description</caption>
               <thead>
                 <tr>
-                  <th colspan="2">
-                    Enumeration description
-                  </th>
+		  <th>Enum value</th><th>Description</th>
                 </tr>
               </thead>
               <tbody>
@@ -6437,11 +6428,10 @@ <h4>
 };</pre>
               <table data-link-for="RTCIceProtocol" data-dfn-for=
               "RTCIceProtocol" class="simple">
+	      <caption>{{RTCIceProtocol}} Enumeration description</caption>
                 <thead>
                   <tr>
-                    <th colspan="2">
-                      Enumeration description
-                    </th>
+		    <th>Enum value</th><th>Description</th>
                   </tr>
                 </thead>
                 <tbody>
@@ -6480,13 +6470,12 @@ <h4>
   "so"
 };</pre>
               <table data-link-for="RTCIceTcpCandidateType" data-dfn-for=
-              "RTCIceTcpCandidateType" class="simple">
+		     "RTCIceTcpCandidateType" class="simple">
+		<caption>{{RTCIceTcpCandidateType}} Enumeration description</caption>
                 <thead>
                   <tr>
-                    <th colspan="2">
-                      Enumeration description
-                    </th>
-                  </tr>
+		    <th>Enum value</th><th>Description</th>
+		  </tr>
                 </thead>
                 <tbody>
                   <tr>
@@ -6544,12 +6533,11 @@ <h4>
   "relay"
 };</pre>
               <table data-link-for="RTCIceCandidateType" data-dfn-for=
-              "RTCIceCandidateType" class="simple">
+		     "RTCIceCandidateType" class="simple">
+		<caption>{{RTCIceCandidateType}} Enumeration description</caption>
                 <thead>
                   <tr>
-                    <th colspan="2">
-                      Enumeration description
-                    </th>
+		    <th>Enum value</th><th>Description</th>
                   </tr>
                 </thead>
                 <tbody>
@@ -8294,11 +8282,10 @@ <h2>
   "stopped"
 };</pre>
           <table class="simple">
+	    <caption><dfn>RTCRtpTransceiverDirection</dfn> Enumeration description</caption>
             <thead>
               <tr>
-                <th colspan="2">
-                  <dfn>RTCRtpTransceiverDirection</dfn> Enumeration description
-                </th>
+		<th>Enum value</th><th>Description</th>
               </tr>
             </thead>
             <tbody data-link-for="RTCRtpTransceiverDirection" data-dfn-for=
@@ -11458,11 +11445,10 @@ <h3>
 };</pre>
           <table data-link-for="RTCDtlsTransportState" data-dfn-for=
           "RTCDtlsTransportState" class="simple">
+	    <caption>{{RTCDtlsTransportState}} Enumeration description</caption>
             <thead>
               <tr>
-                <th colspan="2">
-                  Enumeration description
-                </th>
+		<th>Enum value</th><th>Description</th>
               </tr>
             </thead>
             <tbody>
@@ -12274,11 +12260,10 @@ <h4>
 };</pre>
             <table data-link-for="RTCIceGathererState" data-dfn-for=
             "RTCIceGathererState" class="simple">
+	      <caption>{{RTCIceGathererState}} Enumeration description</caption>
               <thead>
                 <tr>
-                  <th colspan="2">
-                    {{RTCIceGathererState}} Enumeration description
-                  </th>
+		  <th>Enum value</th><th>Description</th>
                 </tr>
               </thead>
               <tbody>
@@ -12331,12 +12316,11 @@ <h3>
   "closed"
 };</pre>
             <table data-link-for="RTCIceTransportState" data-dfn-for=
-            "RTCIceTransportState" class="simple">
+		   "RTCIceTransportState" class="simple">
+	      <caption><{{RTCIceTransportState}} Enumeration description</caption>
               <thead>
                 <tr>
-                  <th colspan="2">
-                    {{RTCIceTransportState}} Enumeration description
-                  </th>
+                  <th>Enum value</th><th>Description</th>
                 </tr>
               </thead>
               <tbody>
@@ -12539,12 +12523,11 @@ <h3>
   "controlled"
 };</pre>
             <table data-link-for="RTCIceRole" data-dfn-for="RTCIceRole" class=
-            "simple">
+		   "simple">
+	      <caption>{{RTCIceRole}} Enumeration description</caption>
               <thead>
                 <tr>
-                  <th colspan="2">
-                    {{RTCIceRole}} Enumeration description
-                  </th>
+		  <th>Enum value</th><th>Description</th>
                 </tr>
               </thead>
               <tbody>
@@ -12587,12 +12570,11 @@ <h3>
   "rtcp"
 };</pre>
             <table data-link-for="RTCIceComponent" data-dfn-for=
-            "RTCIceComponent" class="simple">
+		   "RTCIceComponent" class="simple">
+	      <caption>{{RTCIceComponent}} Enumeration description</caption>
               <thead>
                 <tr>
-                  <th colspan="2">
-                    {{RTCIceComponent}} Enumeration description
-                  </th>
+                  <th>Enum value</th><th>Description</th>
                 </tr>
               </thead>
               <tbody>
@@ -13306,12 +13288,11 @@ <h3>
 };</pre>
             <table data-link-for="RTCSctpTransportState" data-dfn-for=
             "RTCSctpTransportState" class="simple">
+	    <caption>{{RTCSctpTransportState}} Enumeration description</caption>
               <thead>
                 <tr>
-                  <th colspan="2">
-                    Enumeration description
-                  </th>
-                </tr>
+		  <th>Enum value</th><th>Description</th>
+		</tr>
               </thead>
               <tbody>
                 <tr>
@@ -14417,11 +14398,10 @@ <h2>
   "closed"
 };</pre>
           <table class="simple">
+	    <caption><dfn>RTCDataChannelState</dfn> Enumeration description</caption>
             <thead>
               <tr>
-                <th colspan="2">
-                  <dfn>RTCDataChannelState</dfn> Enumeration description
-                </th>
+		<th>Enum value</th><th>Description</th>
               </tr>
             </thead>
             <tbody data-link-for="RTCDataChannelState" data-dfn-for=
@@ -16788,12 +16768,11 @@ <h3>
 };</pre>
         </div>
         <table data-link-for="RTCErrorDetailType" data-dfn-for=
-        "RTCErrorDetailType" class="simple">
+               "RTCErrorDetailType" class="simple">
+	  <caption>{{RTCErrorDetailType}} Enumeration description</caption>
           <thead>
             <tr>
-              <th colspan="2">
-                Enumeration description
-              </th>
+	      <th>Enum value</th><th>Description</th>
             </tr>
           </thead>
           <tbody>