Jorge Godoy schrieb: > Em Wednesday 07 November 2007 20:55:14 Florent Aide escreveu: >> And some clear docs then. Because even with good comments just above >> it, the usage of __all__ and its *real* meaning and impact could be >> deceptive to someone not used with the intricacies of python. > > I'm still not convinced that this is good... But, at least a link to > Python's > docs on this would be needed. It is better than rewriting the documentation > itself. We can complement it with comments, but we should show that this is > Python protecting them not something that TG added. It will be nice if > people start using this outside of TG applications as well. ;-)
Right, stuffing model.py full with doc comments will only decrease its readability. Maybe we should add a wiki page where we put a commented version of a default model.py and then just add a link to that page in the model.py of a quickstarted project? The same could be done for controllers.py. Chris --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
