summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md24
1 files changed, 24 insertions, 0 deletions
diff --git a/README.md b/README.md
index 99c2491..1497214 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,26 @@
+# A Party of Dice
+
+A game simulation I wrote to help me better understand Go concurrency
+concepts.
+
+Based loosely on the `makeThumbnails6` example in Chapter 8 (page 238)
+of *The Go Programming Language* (Addison-Wesley, 2016).
+
+# Usage
+
+The following invocation runs the simulation with two players, each of
+which plays with a six-sided die:
+
+`go run . -n 2 -sides 6`
+
+Since 2 and 6 are the default values, in this case the following is
+equivalent:
+
+`go run .`
+
+Of course, `go run . -help` will print a detailed listing of available
+command-line arguments.
+
# The Scene
Several people agree to convene to play a game of dice. Beforehand,
@@ -19,3 +42,4 @@ the case of a tie, the first one to roll the winning number wins. For
example, if player 1 hits the number in three turns, then player 2
hits the number in two turns, then player 3 also in two turns, player
2 wins.
+