docs(admin/networking): scope the CORS matrix headers and caption the table

Without a scope, a <th> in a row with no data cells is a column header, so
From user and From workspace, which span the first three columns, became
column headers for the body's label columns alongside To user, To workspace
and To app. A screen reader on "Alice" announced "To user, From workspace,
From user", which contradicts itself.

The From cells now have scope="row" and the other header-row cells
scope="col", so each label stays on its own header row. The body's user,
workspace and app labels become row headers, so each check or cross mark is
announced with both its destination and its origin. The third header row
puts App A to App D beside the To labels with nothing saying they are the
origin apps, so a caption states that columns are the origin and rows the
destination, matching the From and To labels the table already uses.

Assisted-by: AI
This commit is contained in:
Nick Vigilante committed 2026-10-16 15:27:59 -04:00
1 parent 709a58f603
commit 8e61ff3afa
1 file changed
+28 -23
+28 -23
View File
@@ -243,57 +243,62 @@ configurable by either admins or users.
#### Allowed by default
<table class="tg">
<caption>
Requests between forwarded apps that the dashboard allows by default.
Columns are the origin: the user, workspace, and app that sends the request.
Rows are the destination: the user, workspace, and app that receives it.
</caption>
<thead>
<tr>
<th class="tg-0pky" colspan="3">From user</th>
<th class="tg-0pky" colspan="3">Alice</th>
<th class="tg-0pky">Bob</th>
<th class="tg-0pky" scope="row" colspan="3">From user</th>
<th class="tg-0pky" scope="col" colspan="3">Alice</th>
<th class="tg-0pky" scope="col">Bob</th>
</tr>
<tr>
<th class="tg-0pky" colspan="3">From workspace</th>
<th class="tg-0pky">Workspace 1</th>
<th class="tg-0pky" colspan="2">Workspace 2</th>
<th class="tg-0pky">Workspace 3</th>
<th class="tg-0pky" scope="row" colspan="3">From workspace</th>
<th class="tg-0pky" scope="col">Workspace 1</th>
<th class="tg-0pky" scope="col" colspan="2">Workspace 2</th>
<th class="tg-0pky" scope="col">Workspace 3</th>
</tr>
<tr>
<th class="tg-0pky">To user</th>
<th class="tg-0pky">To workspace</th>
<th class="tg-0pky">To app</th>
<th class="tg-0pky">App A</th>
<th class="tg-0pky">App B</th>
<th class="tg-0pky">App C</th>
<th class="tg-0pky">App D</th>
<th class="tg-0pky" scope="col">To user</th>
<th class="tg-0pky" scope="col">To workspace</th>
<th class="tg-0pky" scope="col">To app</th>
<th class="tg-0pky" scope="col">App A</th>
<th class="tg-0pky" scope="col">App B</th>
<th class="tg-0pky" scope="col">App C</th>
<th class="tg-0pky" scope="col">App D</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tg-0pky" rowspan="3">Alice</td>
<td class="tg-0pky" rowspan="2">Workspace 1</td>
<td class="tg-0pky">App A</td>
<th class="tg-0pky" scope="row" rowspan="3">Alice</th>
<th class="tg-0pky" scope="row" rowspan="2">Workspace 1</th>
<th class="tg-0pky" scope="row">App A</th>
<td class="tg-0pky">✅</td>
<td class="tg-0pky">✅<span style="font-weight:400;font-style:normal">*</span></td>
<td class="tg-0pky">✅<span style="font-weight:400;font-style:normal">*</span></td>
<td class="tg-0pky">❌</td>
</tr>
<tr>
<td class="tg-0pky">App B</td>
<th class="tg-0pky" scope="row">App B</th>
<td class="tg-0pky">✅*</td>
<td class="tg-0pky">✅</td>
<td class="tg-0pky">✅<span style="font-weight:400;font-style:normal">*</span></td>
<td class="tg-0pky">❌</td>
</tr>
<tr>
<td class="tg-0pky">Workspace 2</td>
<td class="tg-0pky">App C</td>
<th class="tg-0pky" scope="row">Workspace 2</th>
<th class="tg-0pky" scope="row">App C</th>
<td class="tg-0pky">✅<span style="font-weight:400;font-style:normal">*</span></td>
<td class="tg-0pky">✅<span style="font-weight:400;font-style:normal">*</span></td>
<td class="tg-0pky">✅</td>
<td class="tg-0pky">❌</td>
</tr>
<tr>
<td class="tg-0pky">Bob</td>
<td class="tg-0pky">Workspace 3</td>
<td class="tg-0pky">App D</td>
<th class="tg-0pky" scope="row">Bob</th>
<th class="tg-0pky" scope="row">Workspace 3</th>
<th class="tg-0pky" scope="row">App D</th>
<td class="tg-0pky">❌</td>
<td class="tg-0pky">❌</td>
<td class="tg-0pky">❌</td>