Branch, commit, and working-copy semantics on cloud projects.
Cloud project versioning follows a Git-like model:
- Branch — named pointer to the latest commit (HEAD)
- Commit — immutable content snapshot with message
- Working copy — uncommitted edits on the active branch
Terminology
| Term | Definition |
|---|---|
| Branch | Line of work (e.g. main, feature/alerts) |
| Commit | Point-in-time snapshot of project content |
| HEAD | Latest commit on a branch |
| Working copy | Edits not yet committed |
| Default branch | Canonical state (typically main) |
The branch switcher displays an uncommitted count when the working copy diverges from HEAD.
Workflow
Edit
Modify model, specs, or artifacts on the active branch. Changes reside in the working copy.
Commit
Commit changes (toolbar; mobile: switcher → Commit…). Message should describe the snapshot. Creates new HEAD.
Review
Changes page — compare commits or visual diff against another branch.
Promote
Set as default when the branch represents approved canonical state. See Merge in Studio.
Branch attributes
| Attribute | Behavior |
|---|---|
| Default | Canonical; cannot archive. Must be Standard or Protected. |
| Standard | Team-visible. Edit via a personal working copy, then merge yourself. Can sync with Git. |
| Protected | Like Standard, but landing requires a merge request and a review from another editor. Can sync with Git. |
| Collab | Live shared editing. Visible only to invited members (or all project editors). Not synced with Git. A collab with only you is a private room. |
| Temporary | System working copy (main*) created when you edit a Standard or Protected branch. |
| Archived | Excluded from UI lists; history retained |
Reset to commit rewinds HEAD and discards subsequent commits on that branch. Restrict to non-default branches and intentional rollback.
Working copy is per-branch. Commit or discard before switching branches when handing off work. The Problems dock shows compiler diagnostics for the working copy and live errors from open editors (YAML, MDX, diagrams).
Last updated on