Proposal: doc.go for each package

[William Reade]

On Wed, Aug 26, 2015 at 3:11 PM, Frank Mueller <frank.mueller at canonical.com>
wrote:
>
> So, what do you think?
>

I think it's a good idea :-). I wouldn't want to mandate immediate
introduction everywhere, but I think it's reasonable to require it for new
code, and for non-trivial changes to older code. Not sure that's quite so
cleanly automatable -- more of a review checklist thing, perhaps? (e.g. I'd
consider package moves to be "trivial", but reviewboard (for example)
doesn't handle them well at all.)

Cheers
William


>
> mue
>
> --
> Frank Mueller <frank.mueller at canonical.com>
> Juju Core Sapphire Team <http://jujucharms.com>
>
> --
> Juju-dev mailing list
> Juju-dev at lists.ubuntu.com
> Modify settings or unsubscribe at:
> https://lists.ubuntu.com/mailman/listinfo/juju-dev
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/juju-dev/attachments/20150826/260202f5/attachment.html>