Matt, did you see this thread? The current TOC was created to address some of the issues with Jason’s original chapter. Just something to keep in mind.

 

 

-----Original Message-----
From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED] On Behalf Of Jason Carreira
Sent:
Wednesday, October 15, 2003 8:19 AM
To: [EMAIL PROTECTED]
Subject: RE: [Webwork] Chapter 3 thoughts

 

Yeah, that occurred to me, but I couldn’t figure out how to avoid the forward references…. Do you think we can defer the configuration discussion until after we’ve talked about the other features? Configuration is pretty central… I guess we could do some hand-waving before this (“we’ll cover the details of configuration later, but for now, this is what your configuration should look like…”), but either way you have forward references.

 

Any ideas how to make it less dry?

 

-----Original Message-----
From: Patrick Lightbody [mailto:[EMAIL PROTECTED]
Sent:
Wednesday, October 15, 2003 2:31 AM
To: [EMAIL PROTECTED]
Subject: [Webwork] Chapter 3 thoughts

-Pat

 

I checked in some of my stuff, but I didn’t get all the way through. Overall, I found the parts where the XML files were taken apart one-by-one to be rather dry and boring. Also, paragraphs should be 4-6 lines if at all possible. Anything more and the reader will loose interest.

 

I’m having a hard time seeing how this chapter can fit early on – it has a lot of forward references which are really annoying to a reader (they want to know now, not be told that in 7 chapters they’ll find out more). I’d like to avoid forward references wherever possible. I’m going to look through our TOC and start work on the intro and chapter 2 and see where this leads.

 

Overall, good content but I think it might just be a bit dry and a bit too much info for such an early chapter.

 

 

 

Reply via email to