<html><head></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><br><div><div>On Mar 26, 2013, at 4:26 AM, Jay McCarthy wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><div>On Mon, Mar 25, 2013 at 2:18 PM, John Clements<br><<a href="mailto:clements@brinckerhoff.org">clements@brinckerhoff.org</a>> wrote:<br><blockquote type="cite">Yikes! In that case, I *really* didn't understand the architecture. Would it make sense to add at least a sentence that alludes to (and ideally points to) documentation on the request handler model? A two-minute scan through the web-server docs doesn't turn up any information on a chain of handlers.<br></blockquote><br>I don't understand this comment. Every section in the Web Server<br>manual (<a href="http://docs.racket-lang.org/web-server-internal/">http://docs.racket-lang.org/web-server-internal/</a>) is about<br>this chain of dispatchers. Section 1 says that the Web server works<br>that way. Section 2 is about each of the standard dispatchers. Section<br>3 is about common patterns. Section 4 is about the particular default<br>chain used by the command line tool. And then the manual is basically<br>over.<br></div></blockquote><div><br></div><div>That's the internals manual. I wasn't aware it existed. Perhaps I would have found it if I'd kept searching, but I maintain that a reasonable-depth reading of /web-server/ doesn't allude to the dispatching model or link to the internals manual. I claim that section 1.2.2, "Web Applications in Racket> Running Web Servlets> Full API" is the right place to put some mention of the dispatching model. </div><div><br></div><div>For instance, between "...module and <span class="RktVar">stuffer</span> is used
as the <a href="http://docs.racket-lang.org/web-server/stateless.html?q=web-server#%28tech._stuffer%29" class="techoutside" data-pltdoc="x"><span class="techinside">stuffer</span></a>." and "Advanced users may need the following options:", I think it might help to add something like this:</div><div><br></div><div>"The Racket Web Server routes requests using a "dispatcher" model. For more information, see [the internals manual]."</div><div><br></div><div>John</div><div><br></div><div><br></div><blockquote type="cite"><div><br>Jay<br><br>--<br>Jay McCarthy <<a href="mailto:jay@cs.byu.edu">jay@cs.byu.edu</a>><br>Assistant Professor / Brigham Young University<br><a href="http://faculty.cs.byu.edu/~jay">http://faculty.cs.byu.edu/~jay</a><br><br>"The glory of God is Intelligence" - D&C 93<br><br>____________________<br> Racket Users list:<br> http://lists.racket-lang.org/users<br></div></blockquote></div><br></body></html>