diff --git a/lib/Moose/Manual/Roles.pod b/lib/Moose/Manual/Roles.pod
index 6a310a4..ad08fab 100644
--- a/lib/Moose/Manual/Roles.pod
+++ b/lib/Moose/Manual/Roles.pod
@@ -253,6 +253,10 @@ probably expects it to implement that method.
 In some use cases we might alias and exclude methods from roles, but
 then provide a method of the same name in the class itself.
 
+One caveat: methods generated by L<MooseX::AttributeHelpers> inside a
+role cannot be C<alias>ed or C<exclude>d.  They are composed into the
+class's namespace, not the role's.
+
 =head1 ROLE EXCLUSION
 
 A role can say that it cannot be combined with some other role. This