Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add minutes pages to Jekyll build process, based on meeting-minutes service #1119

Open
wants to merge 16 commits into
base: main
Choose a base branch
from

Conversation

kfranqueiro
Copy link
Contributor

@kfranqueiro kfranqueiro commented Mar 6, 2025

This adds statically-generated minutes pages, with the following goals:

  • to enable ultimately removing the current minutes pages' reliance on MySQL
  • to better integrate into the WAI website, especially with regard to navigation templates

Keep in mind that this means that minutes index pages will only be updated when we publish new builds.

Of particular note:

  • Resolutions pages now group by meeting, just like the topics pages, but meetings with no resolutions are skipped, because that occurs more often than not
  • I attempted to make titles more consistent across all of the groups/TFs' minutes pages
    • Consistently included and abbreviated WG / TF
    • Abbreviated particularly long names with common abbreviations to avoid extremely long headings
      • Reasoning: any expansion should already have been established by wherever the visitor arrived from
    • Distinguished Minutes / Topics / Resolutions in page title and h1; not in navigation/breadcrumb, since all 3 are strongly correlated (and used to effectively be one endpoint) - see Add navigation entries for minutes pages wai-website-data#195 for the navigation.yml changes
  • MATF minutes page has been updated to include both channels' minutes, and the Communications section of the TF's page has been updated accordingly to only link to the minutes listing page
  • PDF-AAM was not being properly indexed before; this is now fixed
  • The JSON data used to organize channels into groups is stored directly in this repo, as there should not be any reason any other repo would need to access it, and it directly relates to the Jekyll plugin also in this PR
  • The Jekyll plugin will request from the meeting-minutes service at build time; it may take several seconds the first time, but subsequent requests should complete in under 2 seconds

Pages covered in this PR

(note this excludes a number of channels we used to have pages for, e.g. all of the Silver groups for WCAG 3)

Existing WAI/... URL New WAI/... URL
GL/minutes-history about/groups/agwg/minutes
GL/task-forces/coga/minutes about/groups/task-forces/coga/minutes
GL/task-forces/conformance-testing/minutes about/groups/task-forces/conformance-testing/minutes
GL/task-forces/low-vision-a11y-tf/minutes about/groups/task-forces/low-vision-a11y-tf/minutes
GL/task-forces/matf/minutes about/groups/task-forces/matf/minutes
GL/task-forces/wcag2ict/minutes about/groups/task-forces/wcag2ict/minutes
APA/minutes about/groups/apawg/minutes
APA/task-forces/adapt/minutes about/groups/task-forces/adapt/minutes
APA/task-forces/fast/minutes about/groups/task-forces/fast/minutes
APA/task-forces/maturity-model/minutes about/groups/task-forces/maturity-model/minutes
APA/task-forces/pronunciation/minutes about/groups/task-forces/spoken-presentation/minutes
APA/task-forces/research-questions/minutes about/groups/task-forces/research-questions/minutes
ARIA/minutes about/groups/ariawg/minutes
ARIA/task-forces/practices/minutes about/groups/task-forces/practices/minutes
ARIA/task-forces/pdf-aam/minutes about/groups/task-forces/pdf-aam/minutes

@kfranqueiro kfranqueiro requested review from iadawn and remibetin March 6, 2025 16:06
Copy link

netlify bot commented Mar 6, 2025

Deploy Preview for wai-website ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit e7ed28d
🔍 Latest deploy log https://app.netlify.com/sites/wai-website/deploys/67cb40f8f9698d0008dfbd58
😎 Deploy Preview https://deploy-preview-1119--wai-website.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 80 (🔴 down 16 from production)
Accessibility: 100 (no change from production)
Best Practices: 92 (no change from production)
SEO: 100 (no change from production)
PWA: -
View the detailed breakdown and full score reports

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

@kfranqueiro kfranqueiro force-pushed the kgf-jekyll-minutes-generator-services branch from 681ce7c to e7ed28d Compare March 7, 2025 18:54
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