diff --git a/editor/git-essentials.mdx b/editor/git-essentials.mdx index 60967f11b..1b9da3341 100644 --- a/editor/git-essentials.mdx +++ b/editor/git-essentials.mdx @@ -35,7 +35,7 @@ These are the Git concepts you'll encounter most often when using the web editor Your live documentation builds from a **deployment branch**, usually called `main`. Other branches let you work on changes independently. Nothing on a branch affects your live site until you merge it into your deployment branch with a pull request. - When you create a branch, the web editor creates a new branch in your repository. You can switch between branches from the branch dropdown in the toolbar. + When you create a branch, the web editor creates a new branch in your repository. You can search for and switch between branches from the branch dropdown in the toolbar. If you have unsaved changes, the editor lets you bring them to the new branch or leave them on your current branch. The branch that builds your live documentation site, typically called `main`. Changes merged into this branch automatically deploy to your site. diff --git a/guides/branches.mdx b/guides/branches.mdx index e85ab84ab..8e5eec805 100644 --- a/guides/branches.mdx +++ b/guides/branches.mdx @@ -50,10 +50,11 @@ 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 unsaved changes, choose whether to bring them to the new branch or leave them on your current branch. + 1. Click **Create branch**. @@ -96,8 +97,11 @@ 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 dropdown. + 1. Search for a branch by name or scroll through the list. + 1. Click the branch you want to switch to. + + Each branch in the dropdown displays a status indicator so you can see whether it is ready, syncing, or failed. Unsaved changes are lost when switching branches. Save your work first.