Skip to content

Handbook: add a Recent Updates page (weekly handbook changes)#5169

Open
dimitrieh wants to merge 2 commits into
mainfrom
handbook-recent-updates
Open

Handbook: add a Recent Updates page (weekly handbook changes)#5169
dimitrieh wants to merge 2 commits into
mainfrom
handbook-recent-updates

Conversation

@dimitrieh

Copy link
Copy Markdown
Contributor

Description

Adds a handbook Recent Updates page at /handbook/recent-changes/ that lists what changed in the handbook each week (newest first), so the team can review the previous week's changes at the Monday review.

  • Build-time data module (nuxt/server/lib/handbookChanges.mjs) reads git history (git log --name-status) over the handbook content and groups changes by ISO week (Monday start). It scans both the new nuxt/content/handbook/ and legacy src/handbook/ paths, so handbook history survives the Nuxt migration, and folds both onto the same /handbook/... URLs.
  • Exposed via a Nitro route (/api/handbook-changes) that runs during prerender, so the data is inlined into the static page (no server or git needed at runtime).
  • Each week shows the affected pages, then a separate "Pull Requests and Commits" list, deduplicated by PR number (a PR's multiple commits collapse into one row), falling back to the commit SHA for direct pushes.
  • Rendered by HandbookRecentChanges.vue, used in recent-changes.md via the ::handbook-recent-changes MDC component. Large weeks (for example the migration's bulk file move) collapse into a <details>.
  • 10 unit tests cover the week grouping, path-to-URL mapping, and PR-level dedup.

Related Issue(s)

n/a

Checklist

  • I have read the contribution guidelines
  • I have considered the performance impact of these changes
  • Suitable unit/system level tests have been added and they pass
  • Documentation has been updated
  • For blog PRs, an Art Request has been created (instructions)

@dimitrieh

Copy link
Copy Markdown
Contributor Author

@UnicornGunnerz this PR should make it so that there is a page in the handbook that collects what has been changed each week for the general meeting. You can check it out when the preview is ready by changing the url to /handbook/recent-changes/

@netlify

netlify Bot commented Jun 9, 2026

Copy link
Copy Markdown

Deploy Preview for flowforge-website ready!

Name Link
🔨 Latest commit bc30d36
🔍 Latest deploy log https://app.netlify.com/projects/flowforge-website/deploys/6a284f62c81d590008159bb5
😎 Deploy Preview https://deploy-preview-5169--flowforge-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: 75 (🟢 up 4 from production)
Accessibility: 96 (no change from production)
Best Practices: 100 (no change from production)
SEO: 91 (no change from production)
PWA: -
View the detailed breakdown and full score reports

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

@netlify

netlify Bot commented Jun 9, 2026

Copy link
Copy Markdown

Deploy Preview for flowforge-website ready!

Name Link
🔨 Latest commit abbeaa3
🔍 Latest deploy log https://app.netlify.com/projects/flowforge-website/deploys/6a284fdce521a200098eb212
😎 Deploy Preview https://deploy-preview-5169--flowforge-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: 67 (🔴 down 4 from production)
Accessibility: 96 (no change from production)
Best Practices: 100 (no change from production)
SEO: 91 (no change from production)
PWA: -
View the detailed breakdown and full score reports

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

@UnicornGunnerz

Copy link
Copy Markdown
Contributor

@dimitrieh, that's pretty interesting. Will this be public, though? Would others be able to see all our changes?

@dimitrieh

Copy link
Copy Markdown
Contributor Author

Direct preview link is at https://deploy-preview-5169--flowforge-website.netlify.app/handbook/recent-changes

that's pretty interesting. Will this be public, though? Would others be able to see all our changes?

@UnicornGunnerz this takes into account any changes to the handbook which is a public repository. No information gets shared that isn't already public.

@ZJvandeWeg can you take look here? Code and the experience of it needs a brief review (I think the page is slightly slow to load? 🤔)

@dimitrieh dimitrieh marked this pull request as ready for review June 10, 2026 08:00

@UnicornGunnerz UnicornGunnerz left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Approving it but ZJ or Claude should check the code to make sure that it works?

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