update docs and such to use 'cabal repl'

Author: chris-martin

.ghci

@@ -2,46 +2,50 @@
 title: How to build and run the Phrasebook examples
 ---
 
-# Build tools
-
 ## Haskell language server
 
 If you are using Visual Studio Code, we recommend installing the [Haskell](https://marketplace.visualstudio.com/items?itemName=haskell.haskell) extension. Error messages and other helpful annotations will then appear in the editor.
 
-## Using Nix shell
+## ghcid
+
+If you are not using an editor with integrated language support, [ghcid](https://typeclasses.com/ghci/ghcid) is a good alternative.
+
+```sh
+$ ghcid --command 'cabal repl hello-world'
+```
 
-You do not *have to* use Nix to run these Haskell programs, but you may find it convenient.
+## GHCi
 
-1. [Install Nix](https://nixos.org/nix/manual/#chap-installation)
+To open a REPL, use the "cabal repl" command, giving as an argument the name of the program you want to load.
 
-2. Install [Cachix](https://cachix.org/), and add the `typeclasses` cache. This step is optional, but will greatly reduce build time.
+```sh
+$ cabal repl hello-world
+
+λ> main
+hello world
+```
+
+## Using Nix shell
 
-    ```sh
-    $ nix-env -iA 'cachix' -f 'https://cachix.org/api/v1/install'
-    $ cachix use 'typeclasses'
-    ```
+You do not have to use Nix to run these Haskell programs, but you may find it convenient.
 
-3. Enter a Nix shell:
+[Install Nix](https://nixos.org/nix/manual/#chap-installation),
 
-    ```sh
-    $ nix-shell 'tools/shell.nix'
-    ```
+Optionally, install [Cachix](https://cachix.org/) and add the `typeclasses` cache. This step is optional, but will greatly reduce build time.
 
-4. Within the Nix shell, you have all of the dependencies required by the examples in the Phrasebook. For example, you can run commands like `runhaskell` and `ghcid`:
+```sh
+$ nix-env -iA 'cachix' -f 'https://cachix.org/api/v1/install'
+$ cachix use 'typeclasses'
+```
 
-    ```sh
-    [nix-shell]$ ghc --version
-    The Glorious Glasgow Haskell Compilation System, version 9.0.1
-    ```
+Within the Nix shell, you have all of the dependencies required by the examples in the Phrasebook. For example, you can run commands like `runhaskell` and `ghcid`.
 
-    ```sh
-    [nix-shell]$ runhaskell 'hello-world.hs'
-    hello world
-    ```
+```sh
+$ nix-shell 'tools/shell.nix'
 
-    ```sh
-    [nix-shell]$ ghcid --command 'ghci hello-world.hs' --test ':main'
-    ```
+[nix-shell]$ ghc --version
+The Glorious Glasgow Haskell Compilation System, version 9.0.1
+```
 
 ## Outputs
 

docs/build-tools.md

@@ -1,5 +1,3 @@
-# The Haskell Phrasebook
-
 ![Haskell Phrasebook logo](logo.png)
 
 *The Haskell Phrasebook* is a free quick-start Haskell guide comprised of a sequence of small annotated programs. It provides a cursory overview of selected Haskell features, jumping-off points for further reading, and recommendations to help get you writing programs as soon as possible.

docs/readme.md

@@ -1,9 +1,7 @@
 ---
-title: Thanks
+title: 🖤 Thanks
 ---
 
-# 🖤
-
 Thanks to the following people who have [contributed](https://typeclasses.github.io/haskell-phrasebook/contributing) to the Phrasebook:
 
 - [ammatsui](https://github.com/ammatsui) -- [Defining functions](https://github.com/typeclasses/haskell-phrasebook/pull/16), [enum ranges](https://github.com/typeclasses/haskell-phrasebook/pull/17)