Manual changes for suggestions on code review

Author: andrerfcsantos

concepts/for-loops/.meta/config.json

@@ -5,4 +5,4 @@
     "andrerfcsantos"
   ],
   "contributors": []
-}
+}

concepts/for-loops/about.md

@@ -26,7 +26,7 @@ for i := 1; i < 10; i++ {
 }
 ```
 
-This loop will print the numbers from `1` to `9` inclusivé. 
+This loop will print the numbers from `1` to `9` (including `9`). 
 Defining the step is often done using an increment or decrement statement, as shown in the example above.
 
 ## Optional components of the header
@@ -87,7 +87,7 @@ for {
 }
 ```
 
-This loop will never end and will only ever finish if the program exits or has a `break` in its body.
+This loop will only ever finish if the program exits or has a `break` in its body.
 
 ## Labels and goto
 

concepts/for-loops/introduction.md

@@ -1,30 +1,31 @@
 # Introduction
 
+
 ## General syntax
 
-The for loop is one of the most commonly used statements to repeatedly execute some logic. In Go it consists of the `for` keyword, a header and a code block that contains the body of the loop wrapped in curly brackets. The header consists of 3 components separated by semicolons `;`: initilization, condition and step.
+The for loop is one of the most commonly used statements to repeatedly execute some logic. In Go it consists of the `for` keyword, a header and a code block that contains the body of the loop wrapped in curly brackets. The header consists of 3 components separated by semicolons `;`: init, condition and post.
 
 ```go
-for initialization; condition; step {
+for init; condition; post {
   // loop body - code that is executed repeatedly as long as the condition is true
 }
 ```
 
-- The **initialization** component is some code that runs only once before the loop starts.
+- The **init** component is some code that runs only once before the loop starts.
 - The **condition** component must be some expression that evaluates to a boolean and controls when the loop should stop. The code inside the loop will run as long as this condition evaluates to true. As soon as this expression evaluates to false, no more iterations of the loop will run.
-- The **step** component is some code that will run at the end of each iteration.
+- The **post** component is some code that will run at the end of each iteration.
 
 **Note:** Unlike other languages, there are no parentheses `()` surrounding the three components of the header. In fact, inserting such parenthesis is a compilation error. However, the braces `{ }` surrounding the loop body are always required.
 
 ## For Loops - An example
 
-The initialization component usually sets up a counter variable, the condition checks whether the loop should be continued or stopped and the step increments the counter at the end of each repetition.
+The init component usually sets up a counter variable, the condition checks whether the loop should be continued or stopped and the post component usually increments the counter at the end of each repetition.
 
 ```go
 for i := 1; i < 10; i++ {
   fmt.Println(i)
 }
 ```
 
-This loop will print the numbers from `1` to `9` inclusivé. 
+This loop will print the numbers from `1` to `9` (including `9`). 
 Defining the step is often done using an increment or decrement statement, as shown in the example above.

concepts/for-loops/links.json

@@ -11,4 +11,4 @@
         "url": "https://yourbasic.org/golang/for-loop/",
         "description": "Article: 5 basic for loop patterns"
     }
-]
+]

exercises/concept/bird-watcher/.docs/hints.md

@@ -2,20 +2,20 @@
 
 ## 1. Determine the total number of birds that you counted so far
 
-- Refer to the exercise introduction for an example how to use a for loop to iterate over an array.
-- Use a helper variable to store the total count and increase that variable as you go through the array.
+- Refer to the exercise introduction for an example how to use a for loop to iterate over a slice.
+- Use a helper variable to store the total count and increase that variable as you go through the slice.
 - Think about the correct initial value for that helper variable.
 
 ## 2. Calculate the number of visiting birds in a specific week
 
 - This task is similar to the first one, you can copy your code as a starting point.
-- Think about which indexes in the array you would need to take into account for week number 1 and 2, respectively.
+- Think about which indexes in the slice you would need to take into account for week number 1 and 2, respectively.
 - Now find a general way to calculate the first and the last index that should be considered.
-- With that you can set up the for loop to only iterate over the relevant section of the array.
+- With that you can set up the for loop to only iterate over the relevant section of the slice.
 
 ## 3. Fix a counting mistake
 
-- Again you need to set up a for loop to iterate over the whole bird count array.
-- This time you only need to visit every second entry in the array.
+- Again you need to set up a for loop to iterate over the whole bird count slice.
+- This time you only need to visit every second entry in the slice.
 - Change the step so the counter variable is increased accordingly after each iteration.
-- In the body of the for loop you can use the increment operator to change the value of an element in an array in place.
+- In the body of the for loop you can use the increment operator to change the value of an element in a slice in-place.

exercises/concept/bird-watcher/.docs/instructions.md

@@ -21,7 +21,7 @@ TotalBirdCount(birdsPerDay)
 
 Now that you got a general feel for your bird count numbers, you want to make a more fine-grained analysis.
 
-Implement a function `BirdsInWeek` that accepts an array of bird counts per day and a week number.
+Implement a function `BirdsInWeek` that accepts a slice of bird counts per day and a week number.
 
 It returns the total number of birds that you counted in that specific week.
 You can assume weeks are always tracked completely.
@@ -42,7 +42,7 @@ You do not know exactly where it was in between those days but definitely not in
 
 Your bird watcher intuition also tells you that the bird was in your garden on the first day that you tracked in your list.
 
-Given this new information, write a function `FixBirdCountLog` that takes an array of birds counted per day as an argument and returns an array after correcting the counting mistake.
+Given this new information, write a function `FixBirdCountLog` that takes a slice of birds counted per day as an argument and returns the slice after correcting the counting mistake.
 
 ```go
 var birdsPerDay []int = []int{2, 5, 0, 7, 4, 1}

exercises/concept/bird-watcher/.docs/introduction.md

@@ -2,30 +2,30 @@
 
 ## General syntax
 
-The for loop is one of the most commonly used statements to repeatedly execute some logic. In Go it consists of the `for` keyword, a header and a code block that contains the body of the loop wrapped in curly brackets. The header consists of 3 components separated by semicolons `;`: initilization, condition and step.
+The for loop is one of the most commonly used statements to repeatedly execute some logic. In Go it consists of the `for` keyword, a header and a code block that contains the body of the loop wrapped in curly brackets. The header consists of 3 components separated by semicolons `;`: init, condition and post.
 
 ```go
-for initialization; condition; step {
+for init; condition; post {
   // loop body - code that is executed repeatedly as long as the condition is true
 }
 ```
 
-- The **initialization** component is some code that runs only once before the loop starts.
+- The **init** component is some code that runs only once before the loop starts.
 - The **condition** component must be some expression that evaluates to a boolean and controls when the loop should stop. The code inside the loop will run as long as this condition evaluates to true. As soon as this expression evaluates to false, no more iterations of the loop will run.
-- The **step** component is some code that will run at the end of each iteration.
+- The **post** component is some code that will run at the end of each iteration.
 
 **Note:** Unlike other languages, there are no parentheses `()` surrounding the three components of the header. In fact, inserting such parenthesis is a compilation error. However, the braces `{ }` surrounding the loop body are always required.
 
 ## For Loops - An example
 
-The initialization component usually sets up a counter variable, the condition checks whether the loop should be continued or stopped and the step increments the counter at the end of each repetition.
+The init component usually sets up a counter variable, the condition checks whether the loop should be continued or stopped and the post component usually increments the counter at the end of each repetition.
 
 ```go
 for i := 1; i < 10; i++ {
   fmt.Println(i)
 }
 ```
 
-This loop will print the numbers from `1` to `9` inclusivé. 
+This loop will print the numbers from `1` to `9` (including `9`). 
 Defining the step is often done using an increment or decrement statement, as shown in the example above.
 

exercises/concept/bird-watcher/.meta/config.json

@@ -20,4 +20,4 @@
   "forked_from": [
     "javascript/bird-watcher"
   ]
-}
+}

exercises/concept/bird-watcher/.meta/exemplar.go

@@ -1,7 +1,7 @@
 package birdwatcher
 
 // TotalBirdCount return the total bird count by summing
-// the individual day's counts
+// the individual day's counts.
 func TotalBirdCount(birdsPerDay []int) int {
 	count := 0
 	for i := 0; i < len(birdsPerDay); i++ {
@@ -11,7 +11,7 @@ func TotalBirdCount(birdsPerDay []int) int {
 }
 
 // BirdsInWeek returns the total bird count by summing
-// only the items belonging to the given week
+// only the items belonging to the given week.
 func BirdsInWeek(birdsPerDay []int, week int) int {
 	count := 0
 	startOfWeek := (week - 1) * 7
@@ -23,7 +23,7 @@ func BirdsInWeek(birdsPerDay []int, week int) int {
 }
 
 // FixBirdCountLog returns the bird counts after correcting
-// the bird counts for alternate days
+// the bird counts for alternate days.
 func FixBirdCountLog(birdsPerDay []int) []int {
 	for i := 0; i < len(birdsPerDay); i += 2 {
 		birdsPerDay[i]++

exercises/concept/bird-watcher/bird_watcher.go

@@ -1,19 +1,19 @@
 package birdwatcher
 
 // TotalBirdCount return the total bird count by summing
-// the individual day's counts
+// the individual day's counts.
 func TotalBirdCount(birdsPerDay []int) int {
 	panic("Please implement the TotalBirdCount() function")
 }
 
 // BirdsInWeek returns the total bird count by summing
-// only the items belonging to the given week
+// only the items belonging to the given week.
 func BirdsInWeek(birdsPerDay []int, week int) int {
 	panic("Please implement the BirdsInWeek() function")
 }
 
 // FixBirdCountLog returns the bird counts after correcting
-// the bird counts for alternate days
+// the bird counts for alternate days.
 func FixBirdCountLog(birdsPerDay []int) []int {
 	panic("Please implement the FixBirdCountLog() function")
 }