Skip to content
This repository was archived by the owner on Sep 11, 2026. It is now read-only.

chore(deps): upgrade dependencies for Astro 7 (DOCSDEV-75) - #240

Closed
Infi-Knight wants to merge 2 commits into
mainfrom
chore/docsdev-75-ilf-developers-dep-upgrade
Closed

Infi-Knight wants to merge 2 commits into
mainfrom
chore/docsdev-75-ilf-developers-dep-upgrade

Conversation

@Infi-Knight

@Infi-Knight Infi-Knight commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Dependency changes

Core:

  • astro 6.3.8 to 7.2.10
  • @astrojs/starlight 0.39.2 to 0.42.0
  • @astrojs/markdown-remark added at 7.3.0
  • @interledger/docs-design-system 0.13.0 to 0.14.0
  • @astrojs/mdx 5.0.6 to 8.0.0
  • @astrojs/netlify 7.0.7 to 8.2.5
  • starlight-links-validator 0.24.0 to 0.26.0
  • sharp 0.34.5 to 0.35.4

Runtime and content:

  • @linear/sdk 82.0.0 to 92.0.0
  • @netlify/blobs 10.7.4 to 11.0.2
  • @netlify/functions 5.2.0 to 6.0.0
  • markdown-it 14.2.0 to 15.0.1
  • node-html-parser 7.1.0 to 9.0.2
  • html-to-text 10.0.0 to 10.0.1

Tooling: eslint to 10.9.1, eslint-plugin-astro to 3.1.0, astro-eslint-parser to 3.1.0, typescript-eslint to 8.69.0, globals to 17.11.0, prettier to 3.9.6, eslint-plugin-jsx-a11y added at 6.10.2.

Removed @astrojs/node

It was declared at ^10.1.2 but never imported. astro.config.mjs uses netlify() with output: "static". Removing it avoids a pointless major bump.

Markdown processor

Astro 7 makes Sätteri the default. Sätteri does not run remark or rehype plugins, and Starlight follows the same default. This cycle keeps every Starlight site on the unified() processor. This site configures no plugins, so its unified() call takes no arguments.

@astrojs/mdx goes to 8.0.0 because Starlight 0.42 itself depends on @astrojs/mdx ^8 and @astrojs/markdown-satteri ^0.4. An earlier plan draft stopped at MDX 7.0.8, because Starlight 0.41 used mdx ^7 and satteri ^0.3 and MDX 8 conflicted with it. Starlight 0.42 removed that conflict.

Accessibility rules

eslint-plugin-astro 3 exposes accessibility rule sets that version 1 did not. The config now extends flat/jsx-a11y-recommended, which turns on 31 rules. This site reports 0 findings.

Prettier reformats 4 content files

Prettier 3.9.6 normalizes markdown italic markers from *text* to _text_. That is 32 lines across 4 content files. Markdown renders *x* and _x_ identically, so the output does not change. I verified that by comparing rendered text against production.

Test plan

  • bun install clean, only the known stale jsx-a11y peer warning
  • bun run build passed. 78 HTML files, SSR function generated, _redirects emitted
  • starlight-links-validator 0.26.0 reports all internal links valid, and the /participation-guidelines exclusion still applies
  • bun run lint exits 0 at --max-warnings=0
  • 0 accessibility findings with the 31 new rules active
  • MDX blog posts render, 62 blog pages built
  • RFC pages render, 11 pages built, so node-html-parser 9 ran during the build
  • Excerpt util verified directly under markdown-it 15 and html-to-text 10. Href stripping, image skipping and figure skipping all still work.
  • Import surface of every runtime major confirmed present and constructible
  • Rendered text compared against production. One page differs by a single character, and that is pre-existing content drift: production still serves an older version with a double period, while main has one. My diff touches only lines 36 to 54 of that file.
  • @interledger/docs-design-system bumped to ^0.14.0 and rebuilt (commit d2e05a3)
  • Deploy preview: confirm the roadmap page loads data. The roadmap is server rendered, so @linear/sdk 92 and @netlify/blobs 11 did not run during the build.
  • Deploy preview: confirm the sync-now function responds (@netlify/functions 6)
  • After merge, watch the first production deploy. scripts/sync-blob.ts runs on production only, not on previews.

Refs: DOCSDEV-75

Phase 3a of DOCSDEV-75. This site carries the most major bumps in the
cycle, including the only MDX integration in the fleet.

Core:

- astro 6.3.8 to 7.2.10
- @astrojs/starlight 0.39.2 to 0.42.0
- @astrojs/markdown-remark added at 7.3.0
- @astrojs/mdx 5.0.6 to 8.0.0
- @astrojs/netlify 7.0.7 to 8.2.5
- starlight-links-validator 0.24.0 to 0.26.0
- sharp 0.34.5 to 0.35.4

Runtime and content:

- @linear/sdk 82.0.0 to 92.0.0
- @netlify/blobs 10.7.4 to 11.0.2
- @netlify/functions 5.2.0 to 6.0.0
- markdown-it 14.2.0 to 15.0.1
- node-html-parser 7.1.0 to 9.0.2
- html-to-text 10.0.0 to 10.0.1

Tooling:

- eslint 10.2.1 to 10.9.1
- eslint-plugin-astro 1.7.0 to 3.1.0
- astro-eslint-parser 1.4.0 to 3.1.0
- typescript-eslint and @typescript-eslint/parser 8.59.0 to 8.69.0
- globals 17.5.0 to 17.11.0
- prettier 3.8.3 to 3.9.6
- eslint-plugin-jsx-a11y added at 6.10.2

Removed @astrojs/node. It was declared but never imported. The config
uses the Netlify adapter with output: 'static'.

Astro 7 makes Sätteri the default markdown processor. This cycle keeps
every Starlight site on the unified processor. This site configures no
plugins, so its unified() call takes no arguments.

Enabled the eslint-plugin-astro accessibility rules through
flat/jsx-a11y-recommended. This site reports 0 findings.

Prettier 3.9.6 normalizes markdown italic markers from *text* to _text_.
That reformats 32 lines across 4 content files. The rendered output does
not change.

@interledger/docs-design-system stays at 0.13.0. Version 0.14.0 is not
published yet. This site uses the design system for CSS files only, so
it does not need 0.14.0 to build. A follow-up commit bumps it.
@netlify

netlify Bot commented Sep 3, 2026

Copy link
Copy Markdown

Deploy Preview for interledger-org-developers ready!

Name Link
🔨 Latest commit d2e05a3
🔍 Latest deploy log https://app.netlify.com/projects/interledger-org-developers/deploys/6a994cae0de7260008771011
😎 Deploy Preview https://deploy-preview-240--interledger-org-developers.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

Version 0.14.0 is published. It carries the Astro 7 mermaid import fix
and the MermaidWrapper click-target fix.

This site uses the design system for CSS files only, so the bump changes
no rendered output here.
@Infi-Knight
Infi-Knight marked this pull request as ready for review September 3, 2026 10:32
@Infi-Knight Infi-Knight self-assigned this Sep 7, 2026
@Infi-Knight
Infi-Knight requested a review from Anca2022 September 7, 2026 07:33

@Anca2022 Anca2022 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.

Not blocking the PR, but I’m wondering if we need to keep this repo up to date going forward, or if this is the last time we’re planning to update it since it’s been migrated and is no longer deployed.

@JoblersTune

Copy link
Copy Markdown
Contributor

We should not be maintaining this code anymore. It is now deprecated. Sorry i should have pointed that out in the recurring issue. It's now been updated.

@Infi-Knight

Copy link
Copy Markdown
Contributor Author

Anca, you asked whether we keep this repo up to date going forward. Sarah answered it on DOCSDEV-76 today:

Note: we will not maintain the dev portal anymore ... it should be in archived state now

So I suggest we close this PR rather than merge it. The next upgrade cycle, DOCSDEV-76, no longer lists this repo.

The site is already served from elsewhere, which I found before reading her comment:

  • All 13 content files exist in interledger.org-v5 under src/content/docs/developers/, at identical paths.
  • Every live /developers/* page reports generator: Astro v6.0.3, which matches v5. This repo has never been on 6.0.x (its history is ^5.17.1, ^6.1.8, ~6.3.8).
  • v5 owns the redirects: /developers goes to /tech/dev-portal, and /developers/roadmap to /tech/roadmap.
  • /developers/rfcs/ now 404s in production, though this branch still builds all 11 RFC pages.

That also explains the broken deploy preview here. The 404 is text/plain with Netlify's own Not Found - Request ID body, not this site's styled 404.html, and netlify.toml's / redirect never fires. No deploy is bound to the URL. Most likely the Netlify site was wound down with the retirement, though I cannot confirm that without dashboard access.

Thanks for asking the question. It saved the review time on the other PRs.

@Infi-Knight Infi-Knight closed this Sep 9, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants