This scenario describes how to:
Create a topic stream and a pull request.
Rehome a work area.
Make and review changes.
Merge the changes into the parent stream using the pull request.
Amy launches the desktop client and opens the stream QLARIUS_MAIN with the work area C:\Work_Main.
Amy opens her request inbox and sees that she has been assigned QLARIUS_CR_1.
To create a new topic stream for the work, Amy right clicks on QLARIUS_CR_1 and selects New Topic Stream. The following fields are pre-populated by default:
Topic stream name: the request type and ID (CR_1).
Parent stream: the stream on which the topic stream is based (QLARIUS_MAIN). This is the stream the topic stream will be merged into.
Request: the request that will be used to merge the changes (QLARIUS_CR_1).
Rehome: reuse the existing work area.
Amy clicks Create.
The new topic stream is created and opened in the desktop client.
A pull request is automatically created in Pulse at the Draft state. The pull request has the same title as the request.
Note: QLARIUS_MAIN has been configured to automatically create pull requests from new topic streams.
The request QLARIUS_CR_1 is automatically related to the pull request.
The work area is rehomed to the new topic stream so that it can be used for development work.
Amy makes changes to the code in the topic stream and delivers them to the repository.
A request is not required to deliver the changes.
A new peer review in Pulse is not created for the topic stream because changes are associated with the pull request.
Amy opens the pull request in the desktop client.
On the Conversation tab Amy can see that changes were delivered to the topic stream.
Amy has completed her development work so she selects another developer, Fred, as reviewer and moves the pull request to the In Review state.
Fred opens the pull request in the desktop client.
Fred reviews the changes and votes to approve the pull request.
The changes are ready to be merged into QLARIUS_MAIN.
Amy receives a notification that the pull request is approved.
Amy opens the pull request in Pulse. There are no conflicts so she clicks Merge.
The changes are merged into the mainline using request QLARIUS_CR_1.
After the merge has completed successfully, the pull request moves automatically to the Completed state.
Amy rehomes the work area back to the mainline stream, QLARIUS_MAIN.