You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: README.md
+13-28
Original file line number
Diff line number
Diff line change
@@ -14,44 +14,29 @@ _Collaborate and work together on GitHub._
14
14
</header>
15
15
16
16
<!--
17
-
<<< Author notes: Step 3 >>>
17
+
<<< Author notes: Step 4 >>>
18
18
Start this step by acknowledging the previous step.
19
19
Define terms and link to docs.github.com.
20
-
Historic note: this step combines the commend, approve, and needs changes steps from the previous version.
21
20
-->
22
21
23
-
## Step 3: Leave a review
22
+
## Step 4: Suggest changes
24
23
25
-
_You assigned yourself! :tada:_
24
+
_Nice work reviewing that pull request :sparkles:_
26
25
27
-
Pull request reviews ensure quality and maintain momentum of changes to your project.
26
+
Now that you have explored the different ways you can review a pull request it is time to learn how to use _suggest changes_.
28
27
29
-
#### When reviewing a pull request:
28
+
**What is _suggest changes_?**: This feature enables you to recommend a change to a pull request that the author can commit with the push of a button.
30
29
31
-
1. Review the _title_ and _body_ of the pull request, and possibly any associated issue, to understand the intended change.
32
-
1. Review the [diff](https://docs.github.com/en/get-started/quickstart/github-glossary#diff), the comparison of the proposed code, in the context of the whole project.
33
-
1. For most things, try out the proposed change. Check if the actual change matches the intention. Find the repository's [contributing guide](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors) to find out how to review the changes.
34
-
35
-
#### In your review comments:
36
-
37
-
- Identify potential issues, risks, and limitations.
38
-
- Suggest changes and improvements.
39
-
- Share awareness of upcoming changes that the pull request doesn't account for.
40
-
- Ask questions to verify shared understanding.
41
-
- Highlight what the author did well and should keep doing.
42
-
- Prioritize the most important feedback.
43
-
- Be concise _and_ provide meaningful detail.
44
-
- Treat the pull request author with kindness and empathy.
45
-
46
-
When an approval or request for changes is not yet needed, consider using **comments**. An **approval** lets the author know you believe the pull request is safe to merge. **Requesting changes** lets the author know you believe the pull request is not ready to merge.
47
-
48
-
### :keyboard: Activity: Leave a review
30
+
### :keyboard: Activity: Suggest changes
49
31
50
32
1. On the pull request, click **Files changed**.
51
-
1. Click **Review changes**.
52
-
1. Add a comment with your initial thoughts on the pull request.
53
-
1. Select _comment_. You won't be able to _approve_ or _request changes_ to your own pull request.
54
-
1. Click **Submit review**.
33
+
1. Find the `index.html` changes.
34
+
1. Hover your cursor next to the line numbers on the left side of the page.
35
+
1. Click the blue plus icon.
36
+
1. After the comment form appears, click the **Add a suggestion** button. <br>
1. Wait about 20 seconds then refresh this page (the one you're following instructions from). [GitHub Actions](https://docs.github.com/en/actions) will automatically update to the next step.
0 commit comments