From: Dave Rolsky <autarch@urth.org>
Date: Tue, 10 Feb 2009 15:31:27 +0000 (+0000)
Subject: Add another recommendation, always call inner() in the most specific subclass
X-Git-Tag: 0.69~31
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=053c63e06492c7bd465eb0fd676e1410f6d9f5a4;p=gitmo%2FMoose.git

Add another recommendation, always call inner() in the most specific subclass
---

diff --git a/lib/Moose/Manual/BestPractices.pod b/lib/Moose/Manual/BestPractices.pod
index 8204dac..cab1af9 100644
--- a/lib/Moose/Manual/BestPractices.pod
+++ b/lib/Moose/Manual/BestPractices.pod
@@ -99,6 +99,13 @@ L<MooseX::AttributeHelpers> to define an API that exposes those pieces
 of functionality that need exposing. Then you can expose just the
 functionality that you want.
 
+=head2 Always call C<inner> in the most specific subclass
+
+When using C<augment> and C<inner>, we recommend that you call
+C<inner> in the most specific subclass of your hierarchy. This makes
+it possible to subclass further and extend the hierarchy without
+changing the parents.
+
 =head2 Namespace your types
 
 Use some sort of namespacing convention for type names. We recommend