Skip to content

Conversation

@anegg0
Copy link
Contributor

@anegg0 anegg0 commented Dec 12, 2025

This PR provides find-orphaned-files.js, a script to identify orphaned files for maintenance.

Note: this new script has a different use than find-orphan-pages.ts:

  • find-orphaned-files.js: In-depth search for occasional files clean-up
  • find-orphan-pages.ts: Sidebar-only search for CI (will break if files are not well referenced.

Description

Document type

  • Gentle introduction
  • Quickstart
  • How-to
  • Concept
  • FAQ
  • Troubleshooting
  • Reference
  • Third-party content
  • Not applicable

@vercel
Copy link

vercel bot commented Dec 12, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
arbitrum-docs Ready Ready Preview Jan 14, 2026 7:08pm

@anegg0 anegg0 requested a review from Copilot January 12, 2026 23:49
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR introduces a new housekeeping script find-orphaned-files.js to identify orphaned documentation files that are not properly referenced. Unlike the existing find-orphan-pages.ts which focuses on sidebar validation for CI, this script performs a comprehensive search across the entire documentation structure to find files that can be safely deleted.

Changes:

  • Added find-orphaned-files.js script with comprehensive reference detection (sidebars, imports, markdown links, React components)
  • Added find-orphaned-files npm script command

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
scripts/find-orphaned-files.js New script to identify orphaned documentation files with support for partial file detection, autogenerated directories, and numeric prefix matching
package.json Added npm script command to run the new orphaned files script

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link

@EmreDincoglu EmreDincoglu left a comment

Choose a reason for hiding this comment

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

Looks good

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.

3 participants