Work with issues and pull requests

This page describes how to work with issues and pull requests in Secure Source Manager.

Required roles

To get the permissions that you need to work with issues and pull requests, ask your administrator to grant you the following IAM roles:

• Secure Source Manager Instance Accessor (roles/securesourcemanager.instanceAccessor) on the Secure Source Manager instance
• Secure Source Manager Repo Writer (roles/securesourcemanager.repoWriter) on the repository

For more information about granting roles, see Manage access.

You might also be able to get the required permissions through custom roles or other predefined roles.

For information on granting Secure Source Manager roles, see Access control with IAM and Grant users instance access.

View pull requests

You can view all pull requests you have access to, or pull requests for a specific repository.

Empty repositories don't have a Pull requests tab. Once you push to a repository you can view the pull request tab.

To view pull requests or issues assigned to you, navigate to the Secure Source Manager Issues or Pull requests tab and click Assigned to me.

To view pull requests for a repository:

1. In the Secure Source Manager web interface, select your repository.
2. From your repository page, click the Pull requests tab.
3. You can filter or sort the pull requests by using the drop down menus for Assignee, Type, or Sort.

To view all pull requests:

1. In the Secure Source Manager web interface, click the Pull requests tab.

   Note: you must have the Repo Reader role (roles/securesourcemanager.repoReader) on a repository in order to see pull requests for that repository.

2. You can filter or sort the pull requests by using the drop down menus for Assignee, Type, or Sort.

Create a pull request

1. In the Secure Source Manager web interface, select the repository you want to create a pull request for.
2. From the repository page, click the Pull requests tab.
3. Click New pull request.
4. In the merge into menu, select the branch you want to merge the pull request into.
5. In the pull from menu, select the branch to pull from.
6. Click New pull request.
7. Give the pull request a title and description, and attach any relevant files.

8. Click Create pull request.

   You are taken to the pull request page where you can add reviewers, labels, milestones, and assignees.

Edit pull request details

You can add Reviewers, Labels, Milestones, Assignees and a Due date to a pull request.

Note: There are no email notifications for reviewers or assignees in this release.

To add Reviewers, Labels, Milestones, Assignees:

From the pull request page, click the gear icon next to the detail you want to edit.

Edits are saved automatically.

To update the Due date:

1. Click the calendar icon in the Due date section, and select a date.
2. Click the plus icon to save the due date.

Review a pull request

Reviewers can add comments, request changes, and approve a pull request.

To review a pull request assigned to you:

1. In the Secure Source Manager web interface, click the Pull requests tab.
2. Click on Assigned to you.

3. Click on the pull request you want to review.

   The Conversation page opens. You can view any comments left by the pull request author, or other reviewers.

4. To view and comment on the changed files, click the Files changed tab. You can change the behavior of whitespace visibility, view and diff options by clicking the Whitespace, Split view/Unified view, and diff options drop-down menus.

5. To leave a comment, click plus icon next to the line you want to comment on.

6. Click Start review.

7. Leave any additional comments by clicking on the plus icon on the line you want to comment on, then click Add comment.

   Comments support styling with markdown.

8. To send your comments, approve the pull request, or request changes, click Review.

9. Leave a comment to sum up your changes or leave the comment space blank and select from the following options:

   • Approve: approve the changes.
   • Comment: send your comments without approving the pull request.

   • Request changes: request changes to the pull request.

     Note: If you are commenting on your own pull request, you can't approve or request changes to your pull request.

Merge pull requests

1. From the repository page, click the Pull requests tab.
2. Select the pull request you want to merge.
3. If there are no conflicts, click Merge pull request.

View issues

1. In the Secure Source Manager web interface, select your repository.
2. From your repository page, click the Issues tab.
3. You can filter or sort the issues by using the menus for Assignee, Type, or Sort.

Create an issue

1. In the Secure Source Manager web interface, select your repository.
2. From the repository page, click the Issues tab.
3. Click New Issue.
4. Enter the Issue title and description, and then click Create Issue.

5. On the Issue details page you can assign Labels, Milestones, Assignees, and specify a branch, or tag.

   Note: There are no email notifications in this release.

What's next

• Use Git source code management with Secure Source Manager.