Update Game Instructions

[github-learning-lab]

Commenting on Pull Requests

As a collaborator on a repository, you will get and give pull request reviews before merging code. This is important! It ensures quality code and maintains momentum of changes to your project.

As you can see, I've opened this pull request and requested you as a reviewer. Pull requests are places to share the changes made to the repository.

Responsibilities of a reviewer

As a pull request reviewer, your role is to help the pull request author (thats me!) by making sure:

• Code destined for production is of the highest quality
• Intentional shortcuts (technical debt) are commented on and confirmed
• The greater team is aware of potential risks associated with changes

These broad responsibilities can include more specific goals, like:

• Pointing out potential issues in code quality, security, or business logic
• Suggesting other reviewers to the author, when warranted
• Commenting on, approving, or requesting changes on the PR
• Providing suggestions for alternate or better implementation details

Some repositories use a CODEOWNERS file. The CODEOWNERS file assigns responsibility for certain parts of the code to specific individuals or teams. When the CODEOWNERS feature is enabled, only the code owner has the final authority to approve the pull request. Your review may not be a formal approval, but it does show confidence.

Step 2: Communicate in pull requests

When an approval or request for changes is not yet needed, consider using comments. Comments enable you to inquire about the proposed change early in the review process. You don't need to wait until something is complete to make suggestions.

⌨️ Activity: Comment on my pull request

1. On the pull request, click Files changed
2. Hover over the line of code where you'd like to add a comment, and click the blue comment icon
3. In the comment window, type a question or leave a more general comment
4. When you're done, click Add single comment

---

Return to this pull request for my next comment

Sometimes I respond too fast for the page to update! If you perform an expected action and don't see a response, wait a few seconds and refresh the page for your next steps.

[JakobLibak]

Jakob is adding a comment.

[github-learning-lab]

Reviewing Pull Requests

Nice work @JakobLibak. By providing feedback, you've enabled me to reevaluate how I am making my desired change. But, pull request reviews don't stop at commenting. You can also approve or request changes on my pull request.

When you get asked to review something, you should acknowledge the request. Acknowledging a review request could take several forms. It could be leaving a comment on the pull request or leaving a review. In some cases, it could be rejecting the review request altogether.

Before you review, some things to consider

Discern the context

Review the title and body of the pull request to understand the intended change. This should help you identify limitations, boundaries, and other important context.

Observing the progress

As a reviewer, there are certain things to look for when identifying how to best provide feedback. In early stages, reviews should focus on the general direction of the changes. Identify if the goal is possible, rather than nitpicking the style, polish, or wording. Pull requests that are closer to merging should receive a robust review. Thorough testing is one of many ways to ensure the changes won't break the project.

Regardless of timing, focus your feedback on the most essential changes. Suggest changes for minor issues within the pull request. When suggesting major changes, open a separate pull request against the author's branch.

Step 3: Leave a review

I've made some changes to this branch and would love ❤️ it if you could approve this pull request. For now, just approving the pull request will suffice. In a moment we will look at requesting changes. 👍

⌨️ Activity: Approve a pull request

1. In the pull request, click the Files changed tab
2. Review the changes in the pull request by commenting on specific lines
3. Above the changed code, click Review changes
4. Type a comment summarizing your feedback on the proposed changes
5. Select Approve to approve merging the changes proposed in the pull request
6. Click Submit review

---

Return to this pull request for my next comment

Sometimes I respond too fast for the page to update! If you perform an expected action and don't see a response, wait a few seconds and refresh the page for your next steps.