updating documentation and switching to 1.21

Author: ardan-bkennedy

.circleci/config.yml

@@ -10,10 +10,10 @@ jobs:
     steps:
       - checkout
       - run:
-          name: Install Go 1.20
+          name: Install Go 1.21
           command: |
               sudo rm -rf /usr/local/go
-              wget -O go.tgz https://dl.google.com/go/go1.20.linux-amd64.tar.gz
+              wget -O go.tgz https://go.dev/dl/go1.21.0.linux-amd64.tar.gz
               sudo tar -C /usr/local -xzf go.tgz
               which go
               go version

go.mod

@@ -1,6 +1,6 @@
 module github.com/ardanlabs/gotraining
 
-go 1.19
+go 1.21
 
 require (
 	github.com/braintree/manners v0.0.0-20160418043613-82a8879fc5fd

reading/README.md

@@ -419,27 +419,28 @@ https://godoc.org/golang.org/x/tools/go/ssa
 
 [Open issues for the upcoming release](https://dev.golang.org/release)
 
-[Go 1.20 Release Notes](https://golang.org/doc/go1.20) - 2023/02/01  
-[Go 1.19 Release Notes](https://golang.org/doc/go1.19) - 2022/08/02  
-[Go 1.18 Release Notes](https://golang.org/doc/go1.18) - 2022/03/15  
-[Go 1.17 Release Notes](https://golang.org/doc/go1.17) - 2021/08/16  
-[Go 1.16 Release Notes](https://golang.org/doc/go1.16) - 2021/02/16  
-[Go 1.15 Release Notes](https://golang.org/doc/go1.15) - 2020/08/11  
-[Go 1.14 Release Notes](https://golang.org/doc/go1.14) - 2020/02/25  
-[Go 1.13 Release Notes](https://golang.org/doc/go1.13) - 2019/09/03  
-[Go 1.12 Release Notes](https://golang.org/doc/go1.12) - 2019/02/25  
-[Go 1.11 Release Notes](https://golang.org/doc/go1.11) - 2018/08/24  
-[Go 1.10 Release Notes](https://golang.org/doc/go1.10) - 2018/02/16  
-[Go 1.09 Release Notes](https://golang.org/doc/go1.9) - 2017/08/24  
-[Go 1.08 Release Notes](https://golang.org/doc/go1.8) - 2017/02/16  
-[Go 1.07 Release Notes](https://golang.org/doc/go1.7) - 2016/08/15  
-[Go 1.06 Release Notes](https://golang.org/doc/go1.6) - 2016/02/17  
-[Go 1.05 Release Notes](https://golang.org/doc/go1.5) - 2015/08/19  
-[Go 1.04 Release Notes](https://golang.org/doc/go1.4) - 2014/12/10  
-[Go 1.03 Release Notes](https://golang.org/doc/go1.3) - 2014/06/18  
-[Go 1.02 Release Notes](https://golang.org/doc/go1.2) - 2013/12/01  
-[Go 1.01 Release Notes](https://golang.org/doc/go1.1) - 2013/05/13  
-[Go 1.00 Release Notes](https://golang.org/doc/go1.0) - 2012/03/28
+[Go 1.21 Release Notes](https://go.dev/doc/go1.21) - 2023/08/08
+[Go 1.20 Release Notes](https://go.dev/doc/go1.20) - 2023/02/01  
+[Go 1.19 Release Notes](https://go.dev/doc/go1.19) - 2022/08/02  
+[Go 1.18 Release Notes](https://go.dev/doc/go1.18) - 2022/03/15  
+[Go 1.17 Release Notes](https://go.dev/doc/go1.17) - 2021/08/16  
+[Go 1.16 Release Notes](https://go.dev/doc/go1.16) - 2021/02/16  
+[Go 1.15 Release Notes](https://go.dev/doc/go1.15) - 2020/08/11  
+[Go 1.14 Release Notes](https://go.dev/doc/go1.14) - 2020/02/25  
+[Go 1.13 Release Notes](https://go.dev/doc/go1.13) - 2019/09/03  
+[Go 1.12 Release Notes](https://go.dev/doc/go1.12) - 2019/02/25  
+[Go 1.11 Release Notes](https://go.dev/doc/go1.11) - 2018/08/24  
+[Go 1.10 Release Notes](https://go.dev/doc/go1.10) - 2018/02/16  
+[Go 1.09 Release Notes](https://go.dev/doc/go1.9) - 2017/08/24  
+[Go 1.08 Release Notes](https://go.dev/doc/go1.8) - 2017/02/16  
+[Go 1.07 Release Notes](https://go.dev/doc/go1.7) - 2016/08/15  
+[Go 1.06 Release Notes](https://go.dev/doc/go1.6) - 2016/02/17  
+[Go 1.05 Release Notes](https://go.dev/doc/go1.5) - 2015/08/19  
+[Go 1.04 Release Notes](https://go.dev/doc/go1.4) - 2014/12/10  
+[Go 1.03 Release Notes](https://go.dev/doc/go1.3) - 2014/06/18  
+[Go 1.02 Release Notes](https://go.dev/doc/go1.2) - 2013/12/01  
+[Go 1.01 Release Notes](https://go.dev/doc/go1.1) - 2013/05/13  
+[Go 1.00 Release Notes](https://go.dev/doc/go1) - 2012/03/28
 
 
 ## Research Papers

topics/go/packages/slices/example1/example1.go

@@ -8,7 +8,7 @@ package main
 import (
 	"fmt"
 
-	"golang.org/x/exp/slices"
+	"slices"
 )
 
 // BinarySearch searches for target in a sorted slice and returns the

topics/go/packages/slices/example10/example10.go

@@ -7,7 +7,7 @@ package main
 import (
 	"fmt"
 
-	"golang.org/x/exp/slices"
+	"slices"
 )
 
 // Index returns the index of the first occurrence or -1 if not present.

topics/go/packages/slices/example11/example11.go

@@ -7,7 +7,7 @@ package main
 import (
 	"fmt"
 
-	"golang.org/x/exp/slices"
+	"slices"
 )
 
 // Insert adds values into the slices at the specified index and

topics/go/packages/slices/example12/example12.go

@@ -7,7 +7,7 @@ package main
 import (
 	"fmt"
 
-	"golang.org/x/exp/slices"
+	"slices"
 )
 
 // Sort sorts a slice of any ordered type in ascending order.
@@ -52,6 +52,8 @@ func main() {
 	fmt.Println("Is list sorted:", is)
 }
 
-func compare(a, b int) bool {
-	return a < b
+// Compare needs to return 0 if the two values are the same, a positive
+// number of a > b, and a negative number of a < b.
+func compare(a, b int) int {
+	return a - b
 }

topics/go/packages/slices/example13/example13.go

@@ -7,7 +7,7 @@ package main
 import (
 	"fmt"
 
-	"golang.org/x/exp/slices"
+	"slices"
 )
 
 // Replace replaces the elements specified for a given range and returns

topics/go/packages/slices/example2/example2.go

@@ -7,7 +7,7 @@ package main
 import (
 	"fmt"
 
-	"golang.org/x/exp/slices"
+	"slices"
 )
 
 // Clip removes the unused capacity from the slice.

topics/go/packages/slices/example3/example3.go

@@ -7,7 +7,7 @@ package main
 import (
 	"fmt"
 
-	"golang.org/x/exp/slices"
+	"slices"
 )
 
 // Clone creates a new slice value and underlying array with a shallow

topics/go/packages/slices/example4/example4.go

@@ -7,7 +7,7 @@ package main
 import (
 	"fmt"
 
-	"golang.org/x/exp/slices"
+	"slices"
 )
 
 // Compact replaces consecutive runs of equal elements with a single copy.

topics/go/packages/slices/example5/example5.go

@@ -7,7 +7,7 @@ package main
 import (
 	"fmt"
 
-	"golang.org/x/exp/slices"
+	"slices"
 )
 
 // result translates the result of the compare API.

topics/go/packages/slices/example6/example6.go

@@ -7,7 +7,7 @@ package main
 import (
 	"fmt"
 
-	"golang.org/x/exp/slices"
+	"slices"
 )
 
 // Contains reports whether a specified value is present in slice.

topics/go/packages/slices/example7/example7.go

@@ -7,7 +7,7 @@ package main
 import (
 	"fmt"
 
-	"golang.org/x/exp/slices"
+	"slices"
 )
 
 // Delete removes a contiguous set of elements from the slice.

topics/go/packages/slices/example8/example8.go

@@ -7,7 +7,7 @@ package main
 import (
 	"fmt"
 
-	"golang.org/x/exp/slices"
+	"slices"
 )
 
 // Equal reports whether two slices are equal by comparing the length of

topics/go/packages/slices/example9/example9.go

@@ -7,7 +7,7 @@ package main
 import (
 	"fmt"
 
-	"golang.org/x/exp/slices"
+	"slices"
 )
 
 // Grow increases the slice's capacity to guarantee space for another n elements.