: Re: In a "learn to do X" book, should a section review come before the quiz / exercises or after? I am writing a book on how to program in C#.NET. Each of the sections follows this format:

@Frith254

Vote Up Vote Down

Oh no, not another C# book ;)

Joking aside and to your question: Think about what was "dawning" on you and think about your audience.

If you want to write a book for idiots, save your time, idiots don't read books. So do you think your readers are idiots?

You are reading this, so I guess your answer was "No!". Then don't treat them like they were. No matter how you arrange your sections, the reader will have figured out after the first one how you place the sub-sections. I.e. they know where to find the review if they want to use it for the quiz or exercises.

So make it easy for them to find the info they need. Keep in mind that they also need the info after reading your book during coding on a real project. Maybe (instead of googling) they want to pick up your book and look it up. From this scenario would you place it where you do it now? (Just a question to consider for you, I do not have an answer on this one.)

Don't hide information if you want to teach people. They do not have to memorize the info anyway. They always can look things up, they are missing. They are not operating in an emergency room where every delay can decide about life and death.

(0)

Login to post a comment!