Fork Actions on Change Set Listing Page
All fork actions are available directly on the change set listing page.
Creating Forks / Pull Requests
The following steps are applicable to all registered CodePlex users.
Step 1: Create a new Fork of a Project
Go to the Source Control tab of a Mercurial project.
Click on the “Create Fork” link.
Specify a name that will distinguish your intentions, and optionally enter in a description of what the fork is used for.
Once the fork has been created, you’ll be redirected to the “My Forks” view of that project.
At this point, you can toggle the view to see “All Forks” or “My Forks” (the toggle will only be visible if you have existing forks in the project).
Step 2: Fork Clone, Commit, and Push
Since this is your repository, you have full capabilities of committing locally, and pushing changes back up to the central server. This is a key distinction for forks, as the changes in your fork ARE NOT pushed into the central project repository.
Step 3: Create a Pull Request
Once you have pushed all of your changes to your fork (as well as making sure you have pulled the latest changes from the central repository), you’re ready to create a pull request.
When viewing “My Forks”, you’ll see some actions.
Click on “Send Pull Request”, enter your comments and click “Send”.
Applying Pull Requests
The following steps are applicable to project coordinators or developers for a project only.
If you are a Mercurial project owner, and need to get access to unapplied patches, please contact us.
Step 1: Reviewing / Apply Pull Request
As a project contributor, when you visit the forks page, you’ll see that you have the ability to subscribe to pull request notifications.
When a user submits a pull request, you’ll receive an email with their comments and a link to the Fork.
Note: It is recommended that you get fresh clone in case you wish to not accept the changes.
Step 2: Closing the Loop
No matter if you applied or declined the pull request, you should close the loop. This gives the user the reassurance that the pull request was noticed and acted upon.
To do this:
Visit the Forks page again. You’ll notice that we pop all pending pull requests on to the top so it’s easy to get access to them.
Find the pull request you just applied, and click “Apply Pull Request”.
Type a message and click Send.
Note: It’s courteous to give really good feedback when declining a pull request. The user is now able to send another pull request with new changes they’ve made to their fork.