Skip to content

Conversation

@kfranqueiro
Copy link
Collaborator

@kfranqueiro kfranqueiro commented Apr 8, 2025

This PR reorganizes both the reading and writing experience for the list of breaks, using an Astro collection with custom loading logic.

Reading experience

The top-level index page now contains a form with the following controls:

  • Which WCAG version (2.2 or 3) to display for
  • A text field for filtering what is displayed (searches in location, failed SC/requirement name, and description)

Writing experience

Breaks are now documented in the same file as the code (or prose) responsible for them, using a custom @break JSDoc tag or the breaks property in Markdown files.

The README has been updated to document how this works, and also to document the Fixable and FixableRegion components for implementing broken and fixed versions.

Note that documented breaks are not directly bound to particular components (and we don't yet have a way to implement broken vs. fixed prose in Markdown), but this potentially opens the door to doing so if we were to associate IDs with each.

- Define known sections for list of breaks as data
- Allow multiple descriptions defined in a single break
- Merge consecutive entries for the same area + SC/req in list
(These are instances that had site-section-level discussion items)
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.

1 participant