Work with changesets
🔥 This feature is currently considered experimental. Try it out and give feedback by reporting bugs and suggesting new features. It’s not recommended for production use.
👥 This feature is available to all users.
This page explains how to use changesets to work on different versions of the same project.
A changeset is an isolated project state. You can use it to prepare changes without modifying the main project state immediately.
1. Changeset selector
When you open a project, the project header displays a Changeset selector next to the project name.
The selector shows the current changeset name. If you have permission to list changesets, you can open the selector to see the available changesets for the current project.
When you open a project without specifying a target changeset in the URL, the main changeset is opened.
If the URL specifies a target changeset, the project is opened on that changeset instead.
2. Switch changeset
To switch to another changeset:
-
Open the target project.
-
In the project header, click the current Changeset name.
-
Select the changeset you want to open.
The project editor reloads on the selected changeset. If a representation or a selected element was open before the switch, it is not kept automatically because it may not exist in the target changeset.
When you switch changeset, the selected changeset is added to the project URL. If you share the project URL with another user, the current changeset is shared as part of the URL too.
3. Representations and changesets
Representations are attached to a specific changeset. They exist only in the changeset in which they were created.
When you create a new changeset, existing representations are not duplicated into it.
4. Create a changeset
If you have permission to create changesets, the changeset menu contains the Create a new changeset action.
To create a changeset:
-
Open the target project.
-
In the project header, click the current Changeset name.
-
Click Create a new changeset.
-
Enter the changeset name.
-
Click Create.
After creation, the project editor switches to the new changeset.
The new changeset is created as a copy of the main project state.
It contains the same project content at creation time, then evolves independently when users work on it.
The source is always the main changeset, even if you create the new changeset while another changeset is currently open.
4.1. Naming rules
If the name is empty, the creation is rejected. If another changeset already has the same name, the creation is rejected.
|
Changeset names can contain special URL characters such as |