Refresh Your Workspace
When collaborating with others, it's important to keep your workspace up-to-date with everyone's changes to make sure you're working with the latest files and avoid changes that overlap or conflict with each other. You can do this manually via a Git merge or pull—or simply refresh your workspace, when notified, to bring the latest updates into your workspace.
Note:
For optimal performance, the option to refresh your workspace takes effect only in workspaces with fewer than 1000 files.Refresh notifications depend on the target branch to which changes are merged in your project's remote repository. By default, this is the main branch, meaning you'll be notified only when changes are merged to the main branch. If you want to be notified when changes are merged to a different branch in the remote repo, select that branch as the target in the Settings editor before you start making changes in your workspace. This way, you'll be notified whenever changes are made to that branch and can refresh your workspace to pick up those changes.
In addition to merged changes, you can refresh your workspace to pull changes from your current branch in the remote repository. A merge is used when changes exist in the target branch of the remote repository; a pull is used when changes exist in the remote version of the workspace's branch. When both types of changes exist, the pull takes precedence.
Here’s an example of how changes in the remote repository trigger a refresh notification and prompt you to merge the updates: Assume your remote repository contains the main and feature branches. You now create a workspace (with the target branch set to main by default). To start your work, you switch branches and create a new local branch called mywork, based on the feature branch. Because you intend to publish your changes from mywork to feature, you set the target branch to feature in the Settings editor, then start making changes in your workspace. While you're working, a teammate publishes their changes to the remote feature branch. You receive a notification prompting you to refresh your workspace. You do this, merging the latest changes from feature into mywork in your workspace. Once your work is complete, you click Publish to seamlessly merge your changes from mywork into feature in the remote repository.
Here's what to do when you're notified to refresh a workspace:
- Click Refresh Workspace in the notification. Here are examples of what you may see depending on the Git operation required to refresh your workspace:
Tip:
The notification to refresh your workspace is an informational message that clears after five seconds. If you missed the notification or want to take action later, look for the message under Notifications in the header. It's helpful to periodically review unread notifications, so you don't miss important information. VB Studio checks for changes in your repository every 10 minutes.
