Walkthrough

Updated documentation links and redirect targets to consolidate migrations paths to /docs/migrations/why, and removed the docs-only paths-ignore from the pull_request trigger so docs changes no longer skip CI validation.

Changes

Sequence Diagram(s)

sequenceDiagram
    autonumber
    participant Dev as Developer (PR)
    participant GH as GitHub Actions
    participant Repo as Repository
    Dev->>Repo: Push PR with docs changes
    note right of Repo `#DDEEFF`: Previously docs/** ignored\nby pull_request paths-ignore
    Repo->>GH: Evaluate pull_request triggers
    GH->>GH: Match triggers (docs/** no longer ignored)
    GH->>GH: Run commit-validation workflow
    GH-->>Dev: Report CI results

sequenceDiagram
    autonumber
    participant User as Client Request
    participant Site as Docs Site Router
    User->>Site: GET /migrations
    Site->>Site: Lookup redirects
    note right of Site `#E8F5E9`: Updated mapping -> /docs/migrations/why
    Site-->>User: 301 Redirect to /docs/migrations/why

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Focus checks:
  • Ensure both updated links in docs/docs/getting-started.md point to the intended target and render correctly.
  • Verify docs/redirects.ts entries are correct and do not create redirect loops.
  • Confirm removal of paths-ignore: docs/** in .github/workflows/commit-validation.yml matches CI intent and the YAML remains valid.

Possibly related PRs

• docs: collect all migrations documentation in one place #11674 — Modifies migration-related docs and redirect mappings, affecting the same files (docs/redirects.ts, migration docs).
• docs: fix redirect to mongodb page #11584 — Adjusts redirect mappings in docs/redirects.ts; overlaps in redirect target changes.
• chore: update workflows to ignore changes in docs directory #11518 — Changes GitHub workflow trigger behavior for docs paths (inverse change to paths-ignore handling).

Suggested reviewers

• alumni
• naorpeled
• michaelbromley

Poem

🐰 I hopped through links and mapped the way,

Redirected paths where lost docs lay.
CI now wakes when pages change,
A tidy trail in one small range.
🥕 Hooray — the warren's clear today!

Pre-merge checks and finishing touches

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

huh it looks like CI is stuck. the jobs have run in my fork but not here (or at least not reported here).

Looks like checks aren't configured to run on docs only changes

Looks like checks aren't configured to run on docs only changes

typeorm/.github/workflows/commit-validation.yml

Lines 1 to 13 in 51fbcf4

	name: Commit Validation
	on:
	push:
	branches:
	- "**"
	paths-ignore:
	- "docs/**"
	pull_request:
	branches:
	- "**"
	paths-ignore:
	- "docs/**"
	workflow_dispatch:

#11761 should solve that issue. But now it fails, as it's missing fixes from this PR :) @michaelbromley maybe we should lift the build-pass requirement for the moment?

coverage: 76.433%. remained the same
when pulling 3c117c0 on mguida22:guida/fix-migration-links
into 51fbcf4 on typeorm:master.