Skip to main content

Pull request templates

Prophecy supports opening pull requests on your external Git provider to merge development branches to a base branch on a remote repository.

note

You will not see this option if using Prophecy-managed Git for your project.

Enable Pull Request Template​

To enable pull requests:

  1. Open your project metadata.
  2. Open the Settings tab.
  3. Next to Pull Request Template, toggle on the Enabled button.
  4. Review the template URL.

PR template settings

The PR template URL requires two variables which are used to build a URL string. The {{source}} variable represents the active development branch, and the {{destination}} variable represents the base branch to which the development branches need to be merged to, like main.

Examples​

GitHub template

https://github.com/exampleOrg/exampleRepo/compare/{{destination}}...{{source}}?expand=1

An example pull request URL generated from the above template for merging a branch named feature to branch main would look like:

https://github.com/exampleOrg/exampleRepo/compare/main...feature?expand=1

Open Pull Request​

If the pull request template is configured correctly and enabled, you can open a pull request during the Merge step of the Git process.

PR creation

When you open a pull request from the Prophecy interface, Prophecy will redirect you to your external Git provider based on the template defined in the project Settings tab.

Merged Externally​

After you merge any branch remotely:

  1. Open your Prophecy project.
  2. Go to the Merge step of the Git dialog.
  3. Click Merged Externally and Confirm.

Merged externally