On Mon, Mar 1, 2010 at 7:47 AM, Julian Edwards <[email protected]> wrote: > On Monday 01 March 2010 12:27:50 Jonathan Lange wrote: >> On Mon, Mar 1, 2010 at 7:19 AM, Julian Edwards >> >> <[email protected]> wrote: >> > On Monday 01 March 2010 12:10:43 Jonathan Lange wrote: >> >> ... >> >> >> (Also, what makes model objects so special anyway?) >> > >> > Precedent. Pretty much most of our model objects already have this. Our >> > doc strings are mostly awful and where they are not awful they are >> > mediocre. >> >> What I meant was, why does this kind of class need documentation more >> than any other kind of class? > > Because they are the most important class in our code base - they form the > very core of everything that Launchpad does. >
There's a big intersection between "extremely important classes" and "model classes", but they aren't equal. SeriesSourcePackageBranch is a good example of an unimportant model object. SourcePackage and BranchNamespace are good examples of an important non-model object. I guess I'm assuming that by "model" you mean "represents a row in the database", which you might not be. jml _______________________________________________ Mailing list: https://launchpad.net/~launchpad-dev Post to : [email protected] Unsubscribe : https://launchpad.net/~launchpad-dev More help : https://help.launchpad.net/ListHelp
