分支是版本控制中的一项功能,用于指向代码库中的特定提交。你的部署分支(通常为 main)代表用于构建线上文档的内容。除非你选择将其他分支合并到部署分支,否则它们都与线上文档相互独立。 分支允许你为文档创建独立实例,以便在发布前进行更改、获取评审并尝试新方案。你的团队可以在不同分支上同时更新文档的不同部分;在你发布这些更改之前,用户在你的线上站点上看到的内容不会受到影响。 我们建议在更新文档时始终通过分支进行工作,以保持线上站点稳定,并支持评审工作流。
  • 清晰命名分支,便于队友理解你正在做什么。
  • 合并后删除分支,保持代码库整洁。
  • 如进行可能影响他人工作的重大变更,请提前告知团队。

创建分支

  1. 在编辑器工具栏中选择分支名称(通常默认为 main)。
  2. 选择 New Branch
  3. 为分支输入一个描述性名称,例如 update-getting-startedfix-api-examples
  4. 选择 Create Branch

在分支上保存更改

要将更改保存到某个分支,请点击编辑器右上角的 Save Changes 按钮。系统会创建一次提交并将你的工作推送到该分支。

切换分支

  1. 在编辑器工具栏中选择当前分支名称。
  2. 在下拉菜单中选择要切换的分支。
切换分支时,未保存的更改将丢失。请在切换前先保存或发布你的内容。