Always use verify_against_type_constraint to check attribute value
[gitmo/Moose.git] / lib / Moose / Cookbook / FAQ.pod
index ee14c71..6199a26 100644 (file)
@@ -16,7 +16,7 @@ production using Moose, they have been running without
 issue now for well over a year. 
 
 At C<$work> we are re-writing our core offering to use Moose, 
-so it's continued development is assured. 
+so its continued development is assured. 
 
 Several other people on #moose either have apps in production 
 which use Moose, or are in the process of deploying sites 
@@ -284,17 +284,14 @@ is not called for my composed roles?> question in the B<Roles> section.
 
 =head3 What are Traits, and how are they different to Roles?
 
-In Moose, a trait is almost exactly the same thing as a role, except that 
-traits typically register themselves, and thus can be referred to by a short name. 
+In Moose, a trait is almost exactly the same thing as a role, except
+that traits typically register themselves, which allows you to refer
+to them by a short name ("Big" vs "MyApp::Role::Big").
 
-The word I<Role> is typically used to indicate a class building block, which 
-is composed into a class at class composition time, whereas I<Trait> is used to
-indicate functionality which is composed into an instance of a class at runtime 
-to add or modify the behavior of B<that instance>.
-
-But this is all just convention, so don't take it too seriously - nobody
-is going to yell at you if you use them interchangeably, or use one instead
-of the other.
+In Moose-speak, a I<Role> is usually composed into a I<class> at
+compile time, whereas a I<Trait> is usually composed into an instance
+of a class at runtime to add or modify the behavior of B<just that
+instance>.
 
 Outside the context of Moose, traits and roles generally mean exactly the
 same thing. The original paper called them Traits, however Perl 6 will call
@@ -306,7 +303,7 @@ Stevan Little E<lt>stevan@iinteractive.comE<gt>
 
 =head1 COPYRIGHT AND LICENSE
 
-Copyright 2006-2008 by Infinity Interactive, Inc.
+Copyright 2006-2009 by Infinity Interactive, Inc.
 
 L<http://www.iinteractive.com>