From 553c8fbebb139ffd283f6e43b332b47e6628da35 Mon Sep 17 00:00:00 2001
From: Dominique Hazael-Massieux <dom@w3.org>
Date: Thu, 13 Jun 2024 15:06:37 +0200
Subject: [PATCH] Fix broken links

Also add automatic detection of ReSpec errors moving forward
---
 .github/workflows/auto-publish.yml | 21 +++++++++++++++++++++
 index.html                         | 10 ++++------
 2 files changed, 25 insertions(+), 6 deletions(-)
 create mode 100644 .github/workflows/auto-publish.yml

diff --git a/.github/workflows/auto-publish.yml b/.github/workflows/auto-publish.yml
new file mode 100644
index 0000000..d0feb0e
--- /dev/null
+++ b/.github/workflows/auto-publish.yml
@@ -0,0 +1,21 @@
+name: Validate and Auto Publish
+
+on:
+  push:
+    paths:
+      - index.html
+    branches:
+      - main
+  pull_request: {}
+
+jobs:
+  validate-and-publish:
+    name: Validate and Publish
+    runs-on: ubuntu-20.04 # only linux supported at present
+    steps:
+      - uses: actions/checkout@v4
+      - uses: w3c/spec-prod@v2 # use the action
+        with:
+          TOOLCHAIN: respec
+          W3C_NOTIFICATIONS_CC: "dom@w3.org"
+          VALIDATE_LINKS: false
diff --git a/index.html b/index.html
index c14d570..e3a7a8d 100644
--- a/index.html
+++ b/index.html
@@ -243,10 +243,8 @@ <h3>Algorithms</h3>
               <li>
                 <p>Let <var>descriptor</var> be a {{PermissionDescriptor}}
                 with its {{PermissionDescriptor/name}} member set to the permission name
-                associated with <var>kind</var> (e.g. {{PermissionName/"camera"}} for
-                <code>"video"</code>, {{PermissionName/"microphone"}} for <code>"audio"</code>), and,
-                optionally, consider its {{DevicePermissionDescriptor/deviceId}} member set to any appropriate
-                device's <var>deviceId</var>.</p>
+                associated with <var>kind</var> (e.g. [="camera"=] for
+                <code>"video"</code>, [="microphone"=] for <code>"audio"</code>).</p>
               </li>
               <li>
                 <p>If the number of unique devices sourcing tracks of
@@ -402,7 +400,7 @@ <h3>Transferable MediaStreamTrack</h3>
         <li><p>Set <var>dataHolder</var>.`[[constraints]]` to <var>value</var> active constraints.</p></li>
         <li><p>Set <var>dataHolder</var>.`[[contentHint]]` to <var>value</var> application-set content hint.</p></li>
         <li><p>Set <var>value</var>.`[[IsDetached]]` to <code>true</code>.</p></li>
-        <li><p>Set <var>value</var>.{{MediaStreamTrack/[[ReadyState]]}} to <a data-cite="!mediacapture-streams/#track-ended">"ended"</a> (without stopping the underlying source or firing an `ended` event).</p></li>
+        <li><p>Set <var>value</var>.<a data-cite="mediacapture-streams#dfn-readystate" data-link-type="attribute">[[\ReadyState]]</a> to {{MediaStreamTrackState/"ended"}} (without stopping the underlying source or firing an `ended` event).</p></li>
       </ol>
     </div>
     <div><p>{{MediaStreamTrack}} <a data-cite="!HTML/#transfer-receiving-steps">transfer-receiving steps</a>, given <var>dataHolder</var> and <var>track</var>, are:</p>
@@ -414,7 +412,7 @@ <h3>Transferable MediaStreamTrack</h3>
         <li><p>Initialize <var>track</var>.{{MediaStreamTrack/enabled}} to <var>dataHolder</var>.`[[enabled]]`.</p></li>
         <li><p>Initialize <var>track</var>.{{MediaStreamTrack/muted}} to <var>dataHolder</var>.`[[muted]]`.</p></li>
         <li><p>Set <var>track</var> application-set content hint to <var>dataHolder</var>.`[[contentHint]]`.</p></li>
-        <li><p>[=MediaStreamTrack/Initialize the underlying source=] of <var>track</var> to <var>dataHolder</var>.`[[source]]`.</p></li>
+        <li><p>[=Initialize the underlying source=] of <var>track</var> to <var>dataHolder</var>.`[[source]]`.</p></li>
         <li><p>Set <var>track</var>'s constraints to <var>dataHolder</var>.`[[constraints]]`.</p></li>
       </ol>
     </div>