Skip to content

Create export-8.html - #43

Open
zakkinsey wants to merge 4 commits into
mainfrom
35-export---8---note-and-fenote-structure-elements
Open

Create export-8.html#43
zakkinsey wants to merge 4 commits into
mainfrom
35-export---8---note-and-fenote-structure-elements

Conversation

@zakkinsey

Copy link
Copy Markdown
Collaborator

No description provided.

@zakkinsey zakkinsey linked an issue May 5, 2026 that may be closed by this pull request
@zakkinsey

Copy link
Copy Markdown
Collaborator Author

@romantoda - did I hear correctly that, in Derivation, FENote will derive to Span? So maybe we should map FENote to Span?

Comment thread WIP/export-8.html Outdated
Comment thread WIP/export-8.html Outdated
Comment thread WIP/export-8.html
Comment thread WIP/export-8.html Outdated
</tbody>
</table>

<h4 id="role-note-fenote-is-rows-36-40-see-row-98-that-might-clarify-putting-this-note-here-from-the-meeting-in-paris-note-should-be-treated-however-we-decide-to-handle-fenote-question-based-on-derivation-group">`Note FENote is rows 36 - 40 See row 98 - that might clarify? Putting this note here… From the meeting in Paris, Note should be treated however we decide to handle FENote.` <span class="el-context">(Question based on Derivation group conversation (6/28/23) - Note to be derived to &quot;small&quot; - how does this impact us, here?)</span></h4>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think we need this one. There was a note in the Google sheet about treating Note and FENote similarly, which I think is valid. However, on the Export 8 sheet, this is row 6 and the mapping is to doc-endnote, in DPub. Do we need to specify this? Is this something that the author - or remediator - would be expected to set, if the Note tag in question is used as an endnote? Is there "real" value in doing so?
At the same time, as we've previously discussed, there should be our "default" mappings but then if someone adds an ARIA role then that should be honored. So, for example, we should not map to doc-endnote unless that ARIA role has been "assigned" to a tag.

Comment thread WIP/export-8.html Outdated
</table>

<h4 id="role-note-fenote-is-rows-36-40-see-row-98-that-might-clarify-putting-this-note-here-from-the-meeting-in-paris-note-should-be-treated-however-we-decide-to-handle-fenote-question-based-on-derivation-group">`Note FENote is rows 36 - 40 See row 98 - that might clarify? Putting this note here… From the meeting in Paris, Note should be treated however we decide to handle FENote.` <span class="el-context">(Question based on Derivation group conversation (6/28/23) - Note to be derived to &quot;small&quot; - how does this impact us, here?)</span></h4>
<table class="data" aria-labelledby="role-note-fenote-is-rows-36-40-see-row-98-that-might-clarify-putting-this-note-here-from-the-meeting-in-paris-note-should-be-treated-however-we-decide-to-handle-fenote-question-based-on-derivation-group">

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<table class="data" aria-labelledby="role-note-fenote-is-rows-36-40-see-row-98-that-might-clarify-putting-this-note-here-from-the-meeting-in-paris-note-should-be-treated-however-we-decide-to-handle-fenote-question-based-on-derivation-group">
<table class="data">

Comment thread WIP/export-8.html Outdated
</tbody>
</table>

<h4 id="role-note-fenote-is-rows-36-40-see-row-98-that-might-clarify-putting-this-note-here-from-the-meeting-in-paris-note-should-be-treated-however-we-decide-to-handle-fenote-question-based-on-derivation-group">`Note FENote is rows 36 - 40 See row 98 - that might clarify? Putting this note here… From the meeting in Paris, Note should be treated however we decide to handle FENote.` <span class="el-context">(Question based on Derivation group conversation (6/28/23) - Note to be derived to &quot;small&quot; - how does this impact us, here?)</span></h4>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<h4 id="role-note-fenote-is-rows-36-40-see-row-98-that-might-clarify-putting-this-note-here-from-the-meeting-in-paris-note-should-be-treated-however-we-decide-to-handle-fenote-question-based-on-derivation-group">`Note FENote is rows 36 - 40 See row 98 - that might clarify? Putting this note here… From the meeting in Paris, Note should be treated however we decide to handle FENote.` <span class="el-context">(Question based on Derivation group conversation (6/28/23) - Note to be derived to &quot;small&quot; - how does this impact us, here?)</span></h4>
<h4 id="role-note-endnote">`Note`<span class="el-context">(`Note` used as `endnote`)</span></h4>

Comment thread WIP/export-8.html Outdated
</tbody>
</table>

<h4 id="role-note-2">`Note`</h4>

@PaulRayius-2 PaulRayius-2 May 6, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<h4 id="role-note-2">`Note`</h4>
<h4 id="role-note-footnote">`Note` <span class="el-context">(DPub `doc-footnote`)</span></h4>

Comment thread WIP/export-8.html Outdated
</table>

<h4 id="role-note-2">`Note`</h4>
<table class="data" aria-labelledby="role-note-2">

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If we change line 181 then we should change this here, too? So it's not role-note-2 but role-note-footnote?

Comment thread WIP/export-8.html Outdated
<tr>
<th><abbr title="Notes">Notes:</abbr></th>
<td>
<span class="property">Note from PDFa: <code>Consult with W3C: This is &quot;richer&quot; than &quot;generic&quot; in ARIA</code></span>

@PaulRayius-2 PaulRayius-2 May 6, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<span class="property">Note from PDFa: <code>Consult with W3C: This is &quot;richer&quot; than &quot;generic&quot; in ARIA</code></span>
<span class="property">Note: <code>TBD - placeholder</code></span>

This appears multiple times in this export. I think we should remove all of these but I didn't just suggest the deletion in case we wanted to keep the TR as a placeholder or to be consistent.

Comment thread WIP/export-8.html Outdated
</tbody>
</table>

<h4 id="role-note-3">`Note`</h4>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What is "doc-tip"? Is that like a "Tip..." where someone gives "advice"? I don't think that's the intent of the Note tag and if that's what doc-tip is then I don't think we should use this mapping for Note.

Comment thread WIP/export-8.html Outdated
Comment thread WIP/export-8.html Outdated
Comment thread WIP/export-8.html Outdated
Comment thread WIP/export-8.html Outdated
Comment thread WIP/export-8.html Outdated
Comment thread WIP/export-8.html Outdated
Comment thread WIP/export-8.html Outdated
Comment thread WIP/export-8.html Outdated
Comment on lines +145 to +179
<h4 id="role-note-fenote-is-rows-36-40-see-row-98-that-might-clarify-putting-this-note-here-from-the-meeting-in-paris-note-should-be-treated-however-we-decide-to-handle-fenote-question-based-on-derivation-group">`Note FENote is rows 36 - 40 See row 98 - that might clarify? Putting this note here… From the meeting in Paris, Note should be treated however we decide to handle FENote.` <span class="el-context">(Question based on Derivation group conversation (6/28/23) - Note to be derived to &quot;small&quot; - how does this impact us, here?)</span></h4>
<table class="data" aria-labelledby="role-note-fenote-is-rows-36-40-see-row-98-that-might-clarify-putting-this-note-here-from-the-meeting-in-paris-note-should-be-treated-however-we-decide-to-handle-fenote-question-based-on-derivation-group">
<tbody>
<tr>
<th>ARIA Specification</th>
<td><a class="core-mapping" href="https://www.w3.org/TR/dpub-aam-1.1/#role-map-endnote">Role: `doc-endnote`</a> <span class="el-context">(DPub)</span></td>
</tr>
<tr>
<th>Analogous HTML Element</th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th>MSAA + IAccessible2</th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="User Interface Automation">UIA</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="Accessibility Toolkit">ATK</abbr>/<abbr title="Assistive Technology - Service Provider Interface">AT-SPI</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="macOS Accessibility Protocol">AX API</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="Notes">Notes:</abbr></th>
<td>
<span class="property">Note from PDFa: <code>Consult with W3C: This is &quot;richer&quot; than &quot;generic&quot; in ARIA</code></span>
</td>
</tr>
</tbody>
</table>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Delete these lines.

Comment thread WIP/export-8.html Outdated
Comment thread WIP/export-8.html Outdated
Comment thread WIP/export-8.html Outdated
PaulRayius-2 and others added 3 commits May 19, 2026 14:47
Discussed in LWG call 5/19/26

Co-authored-by: PaulRayius-2 <paul@pdfix-us.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Export - 8 - Note and FENote structure elements

4 participants