Am 23.09.2010 16:54 schrieb Mark Ramm:
There was quite a bit of discussion about this at the time, and we decided that it was probably not right to make it impossible (well difficult) to use lookup and default in your urls.
The default() convention was taken over from CherryPy (TG 1), but I agree it makes sense to use underscore names for such magic methods to avoid name conflicts.
My main point was that if we make such changes in the API, the documentation must be updated accordingly, and it must be also mentioned in the TG 2.0 -> 2.1 migration notes because it will break old apps. The reasoning behind the changes should also be mentioned becasue it's so much easier to accept changes when they are properly documented and you understand the reasoning behind them.
The excuse "we will add the documentation later" is not a good one because according to my experience this hardly ever happens, we stick with outdated docs, and newbies get a bad experience when they try out the tutorials in the next release. Please always try to keep the docs and tests in sync with the code.
-- Christoph -- You received this message because you are subscribed to the Google Groups "TurboGears Trunk" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/turbogears-trunk?hl=en.
