编辑器中的 Git 基础
了解 Mintlify 编辑器背后的 Git 版本控制概念,包括 branch、commit、拉取请求和合并工作流。
Git 让你可以控制并跟踪文件的变更。Git 是 docs-as-code 工作流中的首选版本控制系统,在这种工作流中,你会像管理其他任何代码库一样管理文档。
Web 编辑器会替你处理 Git 操作。理解几个关键概念有助于你更好地发挥编辑器的作用,并更高效地与团队协作。
Git 会跟踪对文档所做的每一次更改。它会记录更改了什么、是谁更改的、何时更改的,以及为什么更改。这意味着你可以:
- 查看任意页面的完整历史记录。
- 通过回退到先前版本来撤销更改。
- 在不影响线上站点的情况下进行更新。
- 在更改上线之前先进行审查。
你的文档存储库是构成文档站点的文件及其历史记录的集合。Web 编辑器会连接到此存储库,以同步并发布你的内容。
这些是你在使用 Web 编辑器时最常接触到的 Git 概念。
在 Web 编辑器中的每一次发布操作都对应一次 Git 操作。
| 你在编辑器中的操作 | 背后对应的 Git 操作 |
|---|---|
| 编辑页面 | 更改会自动保存到 Mintlify 服务器(尚未进行 Git 提交) |
| 切换 branch | 切换到所选的 branch |
| 在部署用分支上发布 | 将更改提交到你的存储库并触发一次部署 |
| 在功能 branch 上发布 | 提交更改并创建一个拉取请求 |
| 外部 push 或 CLI 更新 | 传入的更改会自动同步到编辑器中 |
Was this page helpful?Suggest editsRaise issue