improved readability and cleared sections which could have caused more confusion Co-authored-by: Eric Huss <eric@huss.org>
`book-example` is a bit of a strange name given that it's not just an example.