trackler 2.2.1.177 → 2.2.1.178

data/tracks/go/exercises/custom-set/README.md

@@ -11,10 +11,10 @@ unique elements.
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/diamond/README.md

@@ -56,10 +56,10 @@ E·······E
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/difference-of-squares/README.md

@@ -16,10 +16,10 @@ natural numbers is 3025 - 385 = 2640.
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/diffie-hellman/README.md

@@ -41,10 +41,10 @@ secret s.
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/dominoes/README.md

@@ -49,10 +49,10 @@ when ok is true, the test program will check the chain for validity only.
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/error-handling/README.md

@@ -51,10 +51,10 @@ helpful way to return error information from panic recovery.
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/etl/README.md

@@ -50,10 +50,10 @@ game while being scored at 4 in the Hawaiian-language version.
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/flatten-array/README.md

@@ -14,10 +14,10 @@ output: [1,2,3,4,5]
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/food-chain/README.md

@@ -67,10 +67,10 @@ She's dead, of course!
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/forth/README.md

@@ -29,10 +29,10 @@ Words are case-insensitive.
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/gigasecond/README.md

@@ -8,10 +8,10 @@ A gigasecond is 10^9 (1,000,000,000) seconds.
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/grade-school/README.md

@@ -38,10 +38,10 @@ experiment make the code better? Worse? Did you learn anything from it?
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/grains/README.md

@@ -30,10 +30,10 @@ experiment make the code better? Worse? Did you learn anything from it?
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/grep/README.md

@@ -83,10 +83,10 @@ func Search(pattern string, flags, files []string) []string {
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/hamming/README.md

@@ -31,9 +31,10 @@ The Hamming distance between these two DNA strands is 7.
 
 # Implementation notes
 
-The Hamming distance is only defined for sequences of equal length. This means
-that based on the definition, each language could deal with getting sequences
-of equal length differently.
+The Hamming distance is only defined for sequences of equal length, so
+an attempt to calculate it between sequences of different lengths should
+not work. The general handling of this situation (e.g., raising an
+exception vs returning a special value) may differ between languages.
 
 You may be wondering about the `cases_test.go` file. We explain it in the
 [leap exercise][leap-exercise-readme].
@@ -45,10 +46,10 @@ You may be wondering about the `cases_test.go` file. We explain it in the
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/hello-world/README.md

@@ -18,10 +18,10 @@ If everything goes well, you will be ready to fetch your first real exercise.
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/hello-world/hello_test.go

@@ -18,7 +18,7 @@ func TestHelloWorld(t *testing.T) {
 // form `func BenchmarkXxx(*testing.B)` and can be used to test the performance
 // of your implementation. They may not be present in every exercise, but when
 // they are you can run them by including the `-bench` flag with the `go test`
-// command, like so: `go test -bench .`
+// command, like so: `go test -v --bench . --benchmem`
 //
 // You will see output similar to the following:
 //

data/tracks/go/exercises/hexadecimal/README.md

@@ -11,10 +11,10 @@ The program should handle invalid hexadecimal strings.
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/house/README.md

@@ -109,10 +109,10 @@ that lay in the house that Jack built.
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/isbn-verifier/README.md

@@ -44,10 +44,10 @@ Now, it's even trickier since the check digit of an ISBN-10 may be 'X' (represen
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/isogram/README.md

@@ -17,10 +17,10 @@ The word *isograms*, however, is not an isogram, because the s repeats.
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/kindergarten-garden/README.md

@@ -63,10 +63,10 @@ While asking for Bob's plants would yield:
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/largest-series-product/README.md

@@ -17,10 +17,10 @@ the largest product for a series of 6 digits is 23520.
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/leap/README.md

@@ -46,10 +46,10 @@ file. The Go specific transformation of that data lives in the `cases_test.go` f
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/ledger/README.md

@@ -18,10 +18,10 @@ containing that log, this will help reviewers.
 
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.

data/tracks/go/exercises/linked-list/README.md

@@ -1,4 +1,5 @@
 # Linked List
+
 Implement a doubly linked list.
 
 Like an array, a linked list is a simple linear data structure. Several
@@ -11,49 +12,41 @@ In a *doubly linked list* each node also holds a link to the previous
 node.
 
 You will write an implementation of a doubly linked list. Implement a
-`Node` to hold a value and pointers to the next and previous nodes. Then
-implement a `List` which holds references to the first and last node and
-offers functions for adding and removing items.
-
-Your `Node` should have the following fields and functions:
-
-* `Val`: the node's value (we will use `interface{}`).
-* `Next()`: pointer to the next node.
-* `Prev()`: pointer to the previous node.
-* `First()`: pointer to the first node (head).
-* `Last()`: pointer to the last node (tail).
-
-Your `List` should have the following fields and functions:
+Node to hold a value and pointers to the next and previous nodes. Then
+implement a List which holds references to the first and last node and
+offers an array-like interface for adding and removing items:
 
-* `First()`: pointer to the first node (head).
-* `Last()`: pointer to the last node (tail).
-* `PushBack(v interface{})`: insert value at back.
-* `PopBack() (interface{}, error)`: remove value at back.
-* `PushFront(v interface{}) `: remove value at front.
-* `PopFront() (interface{}, error)`: insert value at front.
-* `Reverse()`: reverse the linked list.
+* `push` (*insert value at back*);
+* `pop` (*remove value at back*);
+* `shift` (*remove value at front*).
+* `unshift` (*insert value at front*);
 
-Instead of not covering error conditions, like calling `PopBack` or `PopFront` on an empty list,
-we will follow Go's idiomatic style and implement the error checks as well.
+To keep your implementation simple, the tests will not cover error
+conditions. Specifically: `pop` or `shift` will never be called on an
+empty list.
 
 If you want to know more about linked lists, check [Wikipedia](https://en.wikipedia.org/wiki/Linked_list).
 
 ## Running the tests
+
 To run the tests run the command `go test` from within the exercise directory.
 
-If the test suite contains benchmarks, you can run these with the `-bench`
-flag:
+If the test suite contains benchmarks, you can run these with the `--bench` and `--benchmem`
+flags:
 
-    go test -bench .
+    go test -v --bench . --benchmem
 
 Keep in mind that each reviewer will run benchmarks on a different machine, with
 different specs, so the results from these benchmark tests may vary.
 
 ## Further information
-If you are not familar with linked list, try [this tutorial](https://visualgo.net/en/list).
+
+For more detailed information about the Go track, including how to get help if
+you're having trouble, please visit the exercism.io [Go language page](http://exercism.io/languages/go/about).
 
 ## Source
-Classic CS data structure.
+
+Classic computer science topic
 
 ## Submitting Incomplete Solutions
 It's possible to submit an incomplete solution so you can see how others have completed the exercise.