Skip to content

fix(misc): fix broken nx.dev redirects and remove legacy redirect-rules files#34673

Merged
jaysoo merged 1 commit intomasterfrom
DOC-428
Mar 3, 2026
Merged

fix(misc): fix broken nx.dev redirects and remove legacy redirect-rules files#34673
jaysoo merged 1 commit intomasterfrom
DOC-428

Conversation

@jaysoo
Copy link
Copy Markdown
Member

@jaysoo jaysoo commented Mar 2, 2026

Current Behavior

10 nx.dev URLs return 404 — broken links in CLI output, graph UI, and cloud UI. Additionally:

  • ~20 wildcard redirect rules silently broken because :slug* was never converted to Netlify's */:splat syntax
  • Specific /getting-started/ rules ordered after the wildcard catch-all, sending users to the generic intro page instead of the correct page (e.g., /getting-started/editor-setup)
  • Redirect chain breaks where intermediate targets (e.g., /nx-api/powerpack-*-cache/nx-api/*-cache) had no rule

Expected Behavior

All documented nx.dev URLs resolve correctly. _redirects is the sole source of truth — no more JS generator pipeline.

Changes

  1. Fixed _redirects:

    • Converted all :slug* to */:splat (Netlify syntax)
    • Reordered specific /getting-started/ rules before the wildcard catch-all
    • Added 13 new redirect rules for broken 404 URLs
  2. Fixed astro-docs/netlify.toml:

    • Added 3 redirects for /docs/ path typos (trailing-s, wrong path)
  3. Deleted legacy files (-2,248 lines):

    • redirect-rules.js
    • redirect-rules-docs-to-astro.js
    • redirect-rules.spec.js
    • scripts/generate-netlify-redirects.mjs

Related Issue(s)

Fixes DOC-428

@jaysoo jaysoo requested a review from a team as a code owner March 2, 2026 21:31
@jaysoo jaysoo requested a review from leosvelperez March 2, 2026 21:31
@netlify
Copy link
Copy Markdown

netlify bot commented Mar 2, 2026

Deploy Preview for nx-docs ready!

Name Link
🔨 Latest commit 80bc5ca
🔍 Latest deploy log https://app.netlify.com/projects/nx-docs/deploys/69a65cbbdefcc2baacaef1e5
😎 Deploy Preview https://deploy-preview-34673--nx-docs.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
Copy Markdown

netlify bot commented Mar 2, 2026

Deploy Preview for nx-dev ready!

Name Link
🔨 Latest commit 80bc5ca
🔍 Latest deploy log https://app.netlify.com/projects/nx-dev/deploys/69a6029ca26dc400083382b6
😎 Deploy Preview https://deploy-preview-34673--nx-dev.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.

@nx-cloud
Copy link
Copy Markdown
Contributor

nx-cloud bot commented Mar 2, 2026

View your CI Pipeline Execution ↗ for commit 80bc5ca

Command Status Duration Result
nx affected --targets=lint,test,build,e2e,e2e-c... ✅ Succeeded 9m 5s View ↗
nx run-many -t check-imports check-lock-files c... ✅ Succeeded 3m 20s View ↗
nx-cloud record -- nx-cloud conformance:check ✅ Succeeded 8s View ↗
nx-cloud record -- nx format:check ✅ Succeeded <1s View ↗
nx-cloud record -- nx sync:check ✅ Succeeded <1s View ↗

☁️ Nx Cloud last updated this comment at 2026-03-02 21:48:37 UTC

…es files

## Current Behavior

10 nx.dev URLs return 404 (e.g. /nx-api/nx/documents/release,
/ci/features/polygraph, /code-owners). ~20 wildcard redirect rules
silently broken because :slug* was never converted to Netlify's
*/splat syntax. Specific /getting-started/ rules ordered after the
wildcard catch-all, sending users to the wrong page.

## Expected Behavior

All documented nx.dev URLs resolve correctly. _redirects is the
sole source of truth — no more JS generator pipeline.

## Related Issue(s)

Fixes DOC-428
@jaysoo jaysoo merged commit f42be4e into master Mar 3, 2026
24 checks passed
@jaysoo jaysoo deleted the DOC-428 branch March 3, 2026 14:35
jaysoo added a commit that referenced this pull request Mar 3, 2026
…es files (#34673)

## Current Behavior

10 `nx.dev` URLs return 404 — broken links in CLI output, graph UI, and
cloud UI. Additionally:
- ~20 wildcard redirect rules silently broken because `:slug*` was never
converted to Netlify's `*`/`:splat` syntax
- Specific `/getting-started/` rules ordered after the wildcard
catch-all, sending users to the generic intro page instead of the
correct page (e.g., `/getting-started/editor-setup`)
- Redirect chain breaks where intermediate targets (e.g.,
`/nx-api/powerpack-*-cache` → `/nx-api/*-cache`) had no rule

## Expected Behavior

All documented `nx.dev` URLs resolve correctly. `_redirects` is the sole
source of truth — no more JS generator pipeline.

### Changes

1. **Fixed `_redirects`**:
   - Converted all `:slug*` to `*`/`:splat` (Netlify syntax)
- Reordered specific `/getting-started/` rules before the wildcard
catch-all
   - Added 13 new redirect rules for broken 404 URLs

2. **Fixed `astro-docs/netlify.toml`**:
   - Added 3 redirects for `/docs/` path typos (trailing-s, wrong path)

3. **Deleted legacy files** (-2,248 lines):
   - `redirect-rules.js`
   - `redirect-rules-docs-to-astro.js`
   - `redirect-rules.spec.js`
   - `scripts/generate-netlify-redirects.mjs`

## Related Issue(s)

Fixes DOC-428
jaysoo added a commit that referenced this pull request Mar 3, 2026
…es files (#34673)

## Current Behavior

10 `nx.dev` URLs return 404 — broken links in CLI output, graph UI, and
cloud UI. Additionally:
- ~20 wildcard redirect rules silently broken because `:slug*` was never
converted to Netlify's `*`/`:splat` syntax
- Specific `/getting-started/` rules ordered after the wildcard
catch-all, sending users to the generic intro page instead of the
correct page (e.g., `/getting-started/editor-setup`)
- Redirect chain breaks where intermediate targets (e.g.,
`/nx-api/powerpack-*-cache` → `/nx-api/*-cache`) had no rule

## Expected Behavior

All documented `nx.dev` URLs resolve correctly. `_redirects` is the sole
source of truth — no more JS generator pipeline.

### Changes

1. **Fixed `_redirects`**:
   - Converted all `:slug*` to `*`/`:splat` (Netlify syntax)
- Reordered specific `/getting-started/` rules before the wildcard
catch-all
   - Added 13 new redirect rules for broken 404 URLs

2. **Fixed `astro-docs/netlify.toml`**:
   - Added 3 redirects for `/docs/` path typos (trailing-s, wrong path)

3. **Deleted legacy files** (-2,248 lines):
   - `redirect-rules.js`
   - `redirect-rules-docs-to-astro.js`
   - `redirect-rules.spec.js`
   - `scripts/generate-netlify-redirects.mjs`

## Related Issue(s)

Fixes DOC-428
FrozenPandaz pushed a commit that referenced this pull request Mar 4, 2026
…es files (#34673)

## Current Behavior

10 `nx.dev` URLs return 404 — broken links in CLI output, graph UI, and
cloud UI. Additionally:
- ~20 wildcard redirect rules silently broken because `:slug*` was never
converted to Netlify's `*`/`:splat` syntax
- Specific `/getting-started/` rules ordered after the wildcard
catch-all, sending users to the generic intro page instead of the
correct page (e.g., `/getting-started/editor-setup`)
- Redirect chain breaks where intermediate targets (e.g.,
`/nx-api/powerpack-*-cache` → `/nx-api/*-cache`) had no rule

## Expected Behavior

All documented `nx.dev` URLs resolve correctly. `_redirects` is the sole
source of truth — no more JS generator pipeline.

### Changes

1. **Fixed `_redirects`**:
   - Converted all `:slug*` to `*`/`:splat` (Netlify syntax)
- Reordered specific `/getting-started/` rules before the wildcard
catch-all
   - Added 13 new redirect rules for broken 404 URLs

2. **Fixed `astro-docs/netlify.toml`**:
   - Added 3 redirects for `/docs/` path typos (trailing-s, wrong path)

3. **Deleted legacy files** (-2,248 lines):
   - `redirect-rules.js`
   - `redirect-rules-docs-to-astro.js`
   - `redirect-rules.spec.js`
   - `scripts/generate-netlify-redirects.mjs`

## Related Issue(s)

Fixes DOC-428

(cherry picked from commit f42be4e)
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 9, 2026

This pull request has already been merged/closed. If you experience issues related to these changes, please open a new issue referencing this pull request.

@github-actions github-actions bot locked as resolved and limited conversation to collaborators Mar 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