Project Versioning

What are Versions?

All projects are versioned. This means that every time a change to a project is saved, a new version of that project is created, which reflects the state of that project at that point in time. Versions contain hierachical information: every version has a parent version.

A version may encompass changes to the model structure and content, or to the project metadata (e.g. name or description), or to any of the Data sets associated to that project, or any of the configured dashboards.

Viewing Versions

Project versions can be seen in the project version selector in the top-bar of the workspace.

Versions are labelled by the time and date they were created. Hierarchical information is also exposed: a solid line between two versions indicates that the later version is a direct child of the preceding version. On the other hand, a dashed line indicates the later version was instead created as a child of an earlier version in the list.

Hovering over a version linked by a dashed line will display information about the parent version.

Switching Versions

The currently loaded version is indicated on the timeline by a white dot (as opposed to the grey dots of other versions).

To switch to a different version, simply click one on the timeline in the project selector.

Loaded versions are also reflected in the URL. Navigating to a project using a valid "version" query parameter will load that version of the project. This allows users to send links to specific project versions to others.

Working on Previous Versions

To begin working on previous versions, simply switch to another version as described above, and begin working as normal. You can save your changes, and a new version will be created.