class 'intent' documentation

[Robert Collins]

I've started some documentation about the key classes in bzrlib at
http://bazaar.canonical.com/Classes. This is deliberately not the
-current- behaviour but rather the things we seem to be saying classes
should/should not be responsible for. This gives folk writing code some
simple principles to assess where apis should go. And also whether
things should be public or private. (If its not a prime responsibility,
why is it on the class? If its a helper -> private, if its someone elses
problem, move it:).

Also note that its -not- API documentation, that belongs in the
codebase. Its not intended to be a discussion place - the list is for
that. But once a consensus is reached, updating these pages would help
contributors a lot I think.

Rob


-- 
GPG key available at: <http://www.robertcollins.net/keys.txt>.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20051223/5ee14906/attachment.pgp