On Mar 22, 2011, at 1:57 PM, Anthony wrote: > Thanks for the feedback. I think the new parameter-based system is probably > preferred in general because it's easier, but there are things it cannot do > that can only be done with the pattern-based system, so we probably need to > maintain good examples for both. But perhaps we could at least include some > additional guidance within the example files (e.g., the pattern-based example > file could say "try the other file first -- use this one only if you need the > additional flexibility of the pattern-based system" -- and maybe reference > the book chapter).
That's a good summary of the situation, including the need to make this clearer in the book. At some point I'd like to enable pattern-editing in the parameter-based router, but I'm not quite sure how to do it. At that point, we could deprecate the pattern-based router, I suppose, though it'd still need to be present for compatibility. > > Best, > Anthony > > On Tuesday, March 22, 2011 4:45:58 PM UTC-4, Keith Pettit wrote: > Thanks that helps me understand a bit better. > > Being a newbie I'd suggest just having the one example. When looking I > didn't really know what the files were or that they are competing methods to > do the same thing. Even if the naming is better like you suggest, it would > still make me wonder what the difference is. I'd probably just randomly try > one of the examples and use whatever worked first. I think to make things > easier for the user you should only have the example for the preferred method. > > Just my 2 cents though. > > Thanks again for the help. > >
