Skip to content

docs: reorganize migration guide steps - #320

Merged
christianalfoni merged 1 commit into
neco/repo-deprecation-noticefrom
feature/reorganize-migration-steps
Mar 13, 2026
Merged

docs: reorganize migration guide steps#320
christianalfoni merged 1 commit into
neco/repo-deprecation-noticefrom
feature/reorganize-migration-steps

Conversation

@christianalfoni

Copy link
Copy Markdown
Contributor

Summary

This PR reorganizes the migration guide steps in to provide a more logical flow for users migrating from CodeSandbox Repositories to GitHub Codespaces.

Changes

Step Order Reorganization

The steps have been reordered to follow a more intuitive sequence:

  1. **Step 1: Move tasks to ** - This is now the first step since configuring the devcontainer is a prerequisite for the subsequent steps.

  2. Step 2: Set up Prebuilds - Moved to second position since prebuilds depend on having the devcontainer configuration in place.

  3. Step 3: Create a branch and Codespace - Combined the previous "Create a branch" and "Connect from VS Code desktop" steps into one comprehensive step with sub-sections:

    • From the web - Instructions for creating a Codespace via GitHub.com
    • From VS Code desktop - Instructions for using the VS Code Codespaces extension

Rationale

The previous order had users setting up prebuilds before configuring the devcontainer, which doesn't make sense since prebuilds rely on the devcontainer configuration. The new order follows a logical sequence:

  1. Configure the environment (devcontainer.json)
  2. Enable faster startup (prebuilds)
  3. Start developing (create branch and codespace)

Testing

  • Verified the markdown renders correctly
  • Confirmed all Callout components are properly formatted
  • Steps flow logically from configuration to usage

- Move 'tasks to devcontainer.json' to Step 1
- Move 'prebuilds setup' to Step 2
- Combine 'create branch and codespace' and 'VS Code desktop' into Step 3
- Add sub-sections for web and vscode in Step 3
@codesandbox

codesandbox Bot commented Mar 13, 2026

Copy link
Copy Markdown

Review or Edit in CodeSandbox

Open the branch in Web EditorVS CodeInsiders

Open Preview

@codesandbox-staging

Copy link
Copy Markdown

Review or Edit in CodeSandbox

Open the branch in Web EditorVS CodeInsiders

Open Preview

@vercel

vercel Bot commented Mar 13, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
projects-docs Ready Ready Preview, Comment Mar 13, 2026 0:07am

Request Review

@christianalfoni
christianalfoni marked this pull request as ready for review March 13, 2026 12:09
@christianalfoni
christianalfoni changed the base branch from pr-319 to neco/repo-deprecation-notice March 13, 2026 12:11

@necoline necoline left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

thank you!

@christianalfoni
christianalfoni merged commit 0cd12d9 into neco/repo-deprecation-notice Mar 13, 2026
3 checks passed
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