Skip to content

Conversation

danbarr
Copy link
Collaborator

@danbarr danbarr commented Oct 9, 2025

Description

Some structural polishing and refactoring:

  • Renames all files to .mdx for consistency and less confusion (excluding auto-generated files pulled from the app repo)
  • Re-titles a handful of pages for consistency and brevity
  • Adds some cross-referencing to newer content
  • Some restructuring/re-ordering of guides to group related content

Related issues/PRs

N/A

Screenshots

New structure/titles in guides sections:

image image image

Merge checklist

Content

  • New pages include a frontmatter section with title and description at a minimum
  • Sidebar navigation (sidebars.ts) updated for added, deleted, reordered, or renamed files
  • Redirects added to vercel.json for moved, renamed, or deleted pages (i.e., if the URL slug changed)

Reviews

  • Content has been reviewed for technical accuracy
  • Content has been reviewed for spelling, grammar, and style

Signed-off-by: Dan Barr [email protected]

Copy link

vercel bot commented Oct 9, 2025

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

Project Deployment Preview Comments Updated (UTC)
docs-website Ready Ready Preview Comment Oct 16, 2025 7:25pm

@danbarr danbarr marked this pull request as ready for review October 16, 2025 19:27
@Copilot Copilot AI review requested due to automatic review settings October 16, 2025 19:27
Copy link
Contributor

@Copilot 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 refactors the documentation structure by standardizing file extensions to .mdx, updating page titles for consistency, and reorganizing content for better navigation. The changes aim to improve documentation maintainability and user experience.

Key changes:

  • Standardizes all documentation files to use .mdx extension (except auto-generated files)
  • Updates page titles and sidebar structure for better organization
  • Adds redirects for renamed pages to prevent broken links
  • Improves accessibility with better aria-labels and cross-references

Reviewed Changes

Copilot reviewed 38 out of 44 changed files in this pull request and generated 1 comment.

File Description
vercel.json Adds redirects for renamed pages to maintain URL compatibility
sidebars.ts Restructures navigation with better categorization and updated file references
docusaurus.config.ts Improves accessibility with descriptive aria-labels for social media links
Multiple .mdx files Updates cross-references to use .mdx extensions and improves content organization
Comments suppressed due to low confidence (1)

Copy link
Contributor

@samuv samuv left a comment

Choose a reason for hiding this comment

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

:shipit:

@danbarr danbarr merged commit 335c74a into main Oct 17, 2025
9 checks passed
@danbarr danbarr deleted the update-filenames branch October 17, 2025 13:28
@danbarr danbarr mentioned this pull request Oct 17, 2025
5 tasks
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.

2 participants