Verify changes from remote content
When changes are made to remote content, a standard set of verification processes are performed. For changes to the default project branch or source, the production changes verification process is run. For remote content sources that support branching, the preview changes verification process is used for branches.
Check the Deploys section of your dashboard to view preview and production builds. This screen lets you access the previews and see the logs of the builds.
Preview changes verification
Preview changes verification is performed automatically whenever changes to remote content files come from a branch that isn't the default branch for this remote content source.
An overview of the automatic process is as follows:
- A branch (for example
x-feature
) is created in the Redocly project's repository. - The changes from the remote source are applied on top of the Redocly project's default branch (
default-branch
). - A "Preview build" for
x-feature
branch is run to generate a preview of the site with the changes, and to check for errors.
Production changes verification
Production changes verification happens when the default branch of the remote content source has changes, or a remote content source that does not support branching (such as URL source) has changes.
An overview of the automatic process is as follows:
- A branch (for example
x-feature
) is created in the Redocly project's repository. - The changes from the remote source are applied on top of the Redocly project's default branch (
default-branch
). - Create a pull request from
x-feature
todefault-branch
. - Run "Preview build" for
x-feature
branch to verify that changes do not break the project. - After verifying that the preview build was successful, Reunite automatically merges the open pull request (if Auto-merge is enabled) and starts a production build.
Additional notes
The autogenerated branches will be removed when:
- the remote branch is deleted
- the pull request is merged
Resources
- Learn more about remote content
- Check how to set up remote content for different source types