Deal of the Day

Home » Main » Manning Forums » 2009 » Clojure in Action

Thread: Forward reference

Reply to this Thread Reply to this Thread Search Forum Search Forum Back to Thread List Back to Thread List

Permlink Replies: 0 - Pages: 1
rpgoldman

Posts: 26
From: US
Registered: 11/11/10
Forward reference
Posted: Nov 14, 2010 12:00 PM
  Click to reply to this thread Reply

In the middle of p. 69, you break in with a discussion of the difference between public and private functions before introducing namespaces. It's hard to understand why this was introduced here, and what the reader is supposed to take home from this paragraph.

I suggest you make one of two changes:

1. Move this discussion downstream in the book --- it seems to me to be OK if your reader doesn't know what defn- does at this point in the book.

2. Introduce namespaces much earlier, probably in the whirlwind tour.

I think it might help if you were to ask yourself "what do I expect my reader to be doing as s/he reads this part of the book?" Do you expect the reader to be testing some of these functions in passing? Or do you expect the reader to blow through chapters 2 and 3 before interacting with Clojure? If you expect the reader to be using clojure while reading this part of the book, you can decide whether or not s/he needs to understand namespaces at this point, or can wait till later.

Legend
Gold: 300 + pts
Silver: 100 - 299 pts
Bronze: 25 - 99 pts
Manning Author
Manning Staff
Manning Developmental Editor