Skip to content

chore: remove duplicate roadmap content files - #10211

Open
oscarbol09 wants to merge 1 commit into
nilbuild:masterfrom
oscarbol09:chore/remove-duplicate-content-files
Open

chore: remove duplicate roadmap content files#10211
oscarbol09 wants to merge 1 commit into
nilbuild:masterfrom
oscarbol09:chore/remove-duplicate-content-files

Conversation

@oscarbol09

Copy link
Copy Markdown

What

Removes 61 content files that were duplicates of an existing file for the same node id, keeping only the file whose slug matches the canonical node label in the roadmap database. Also removes files for three node ids that no longer exist in the database (topics removed from the roadmap).

Why

Each topic on a roadmap is linked to its content file by the node id in the file name. When a node label changes (or a sync ran twice), an outdated copy is left behind under a stale slug, e.g.:

  • svelte-kit@P4st_...md duplicated sveltekit@P4st_...md (canonical label: "SvelteKit")
  • 17 x more-excersises@...md (typo) duplicated more-exercises@...md (byte-identical content)
  • mutex@toev...md vs canonical concurrent-ruby@toev...md (label: "Concurrent Ruby")
  • amazon-rds-database@...md vs canonical glue-etl@...md (label: "Glue (ETL)")
  • Files for node ids _nL7Wf1MG3mofKY9XwGDX, 414WIX6TuK2h1jEtzRG2H (forward-deployed-engineer) and XY2l96sry3WyLzzo3KUeU (vibe-coding) were removed entirely -- those nodes no longer exist in the roadmap database.

Verification

  • Canonical slug for every kept file was computed with the repo's own slugger (scripts/lib/slugger.ts) from the live node label fetched via https://roadmap.sh/api/v1-official-roadmap/<slug>.
  • After cleanup, every node id in the repo maps to exactly one content file.
  • No content was edited or renamed; this PR only deletes stale duplicates (502 lines).

Note

A few of the deleted files carried content that is not present in the kept file (e.g. prompt-vs-context-engineering had extra links; type-casting, threads, mutex, byebug described different subtopics under the same node id). Since the database is the source of truth for the official roadmaps, those were removed rather than merged. Happy to salvage any of them if you prefer.

Removes 61 content files that duplicated an existing file for the same node id, keeping only the file whose slug matches the canonical node label in the roadmap database.

Also removes files for three node ids that no longer exist in the database (topic removed from roadmap).

Verified against the official roadmap API: every remaining node id now maps to exactly one content file.
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