basic docs for go-cat

Author: tgvashworth

cli-files/README.md

@@ -148,14 +148,23 @@ If you smash through this, here's some fun/tricky extensions:
 
 ### go-cat
 
-- make sure GOPATH bin setup is correct: https://sourabhbajaj.com/mac-setup/Go/
-- install cobra-cli: https://github.com/spf13/cobra-cli/blob/main/README.md
-- make `go-cat` dir, cd in, `go mod init go-cat`
-- `cobra-cli init .`
-- look at all the files
-- `go install . && go-cat`
-- set up a command that takes an argument, opens the file and prints it out (`os.ReadFile`, `os.Stdout.Write`)
-- handle the error if you pass a directory like cat does
+This one we're going to make in a different, so we can see how to use tools to initialise go projects more quickly.
+
+We'll use the [cobra-cli](https://github.com/spf13/cobra-cli/blob/main/README.md) to initialise a new project. There's a guide on that page to installing it, but it's likely `go install github.com/spf13/cobra-cli@latest`.
+
+Then `cd` to the `cli-files` directory.
+
+Make a `go-cat` directory, `cd` into it, and run `go mod init go-cat` ([documentation here](https://pkg.go.dev/cmd/go#hdr-Initialize_new_module_in_current_directory)).
+
+Then run `cobra-cli init .`. [This command](https://github.com/spf13/cobra-cli/blob/main/README.md) will create your initial application code for you.
+
+Take a look at all the files it has created. See how they differ or are similar to what you did in the `go-ls` example.
+
+Let's try it out: `go install . && go-cat`. It will do nothing, but it's a start.
+
+Now it's over to you: set up a command that takes a path to a file as an argument, then opens that file and prints it out. You'll need the built-in go functions `os.ReadFile` and `os.Stdout.Write`, as well as more from the `os` package.
+
+Bonus task: handle the error if you pass it a directory rather than a file, like cat does.
 
 [go]: https://go.dev/
 [cat]: https://en.m.wikipedia.org/wiki/Cat_(Unix)