diff --git a/guides/branches.mdx b/guides/branches.mdx index e85ab84ab..455a5a018 100644 --- a/guides/branches.mdx +++ b/guides/branches.mdx @@ -50,10 +50,15 @@ Use clear, descriptive names that explain the purpose of a branch. - 1. Click the branch name in the editor. - 1. Click **New Branch**. + 1. Click the branch name in the editor toolbar. + 1. Click **Create new branch**. 1. Enter a descriptive name. - 1. Click **Create Branch**. + 1. If you have pending changes, choose whether to bring them to the new branch or leave them on the current branch. + 1. Click **Create branch**. + + + You can also type a branch name in the search field and press **Enter** to create a branch with that name if no matching branch exists. + @@ -96,11 +101,26 @@ Use clear, descriptive names that explain the purpose of a branch. - 1. Select the branch name in the editor toolbar. - 1. Select the branch you want to switch to from the dropdown menu. + 1. Click the branch name in the editor toolbar to open the branch switcher. + 1. Use the search field to filter branches by name. + 1. Select the branch you want to switch to. + + The branch switcher organizes branches into two sections: + + - **Synced in editor**: Branches that are ready to use in the editor. + - **Not synced in editor**: Branches that exist in your repository but haven't been synced to the editor yet. Selecting one of these branches starts a sync. + + Each branch displays a status badge to help you identify its state: + + | Badge | Meaning | + |-------|---------| + | **Default** | Your deployment branch | + | **Current** | The branch you are working on | + | **Syncing** | The branch is syncing to the editor | + | **Failed** | The branch failed to sync | - Unsaved changes are lost when switching branches. Save your work first. + Unsaved changes are lost when switching branches. Save your work first, or create a new branch and bring your changes with you.