Skip to content

Add initial informative architecture#615

Merged
kfranqueiro merged 25 commits intomainfrom
informative
Mar 12, 2026
Merged

Add initial informative architecture#615
kfranqueiro merged 25 commits intomainfrom
informative

Conversation

@kfranqueiro
Copy link
Contributor

@kfranqueiro kfranqueiro commented Mar 11, 2026

This implements pages under the informative/ URL path, populated via a collection based on files under the informative directory in the repository, which maintains a structure parallel to that found under guidelines/groups/.

  • Includes logic (in src/lib/informative.ts) to inherit properties from normative counterparts (e.g. child order and custom titles) so they don't need to be redundantly defined
  • Adds "Ways to meet" link to each guideline and "Methods" link to each provision within the TR document
  • Reorganizes remark/rehype plugins to share common ones between normative and informative pages
  • Informative pages are based on a combination of what existed in the Eleventy-based prototype, common WAI site patterns, and a few patterns from the WCAG 2 informative docs
  • Expands existing build check to also flag desync between normative and informative directory/file structure
  • Cleans up unused CSS and moves common styles between normative/informative to their own file

(Note: the majority of files added in this PR are skeleton files corresponding to each guideline and provision, and the majority of files removed are from the old Eleventy how-to prototype. This is also why the wcag3-howtos build fails; I will remove that from netlify when we merge this.)

kfranqueiro and others added 23 commits February 13, 2026 16:40
Add in list of provisions
Remove text of guideline
Include status and maturity (experimental)
- Apply status-marker to status to match normative
- Parenthesize type in absence of styles
(There currently are none, but better safe than sorry later)
@kfranqueiro kfranqueiro requested a review from iadawn March 11, 2026 21:13
@netlify
Copy link

netlify bot commented Mar 11, 2026

Deploy Preview for wcag3 ready!

Name Link
🔨 Latest commit bab5cfc
🔍 Latest deploy log https://app.netlify.com/projects/wcag3/deploys/69b1ec75c7df5c00085bb1e3
😎 Deploy Preview https://deploy-preview-615--wcag3.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify
Copy link

netlify bot commented Mar 11, 2026

Deploy Preview for wcag3-howtos failed.

Name Link
🔨 Latest commit bab5cfc
🔍 Latest deploy log https://app.netlify.com/projects/wcag3-howtos/deploys/69b1ec7563d60f0008e696cd

@kfranqueiro kfranqueiro merged commit 7137efe into main Mar 12, 2026
6 of 10 checks passed
@kfranqueiro kfranqueiro deleted the informative branch March 12, 2026 15:33
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.

2 participants