diff --git a/lib/Moose/Manual/Roles.pod b/lib/Moose/Manual/Roles.pod
index 6a310a4..82f649a 100644
--- a/lib/Moose/Manual/Roles.pod
+++ b/lib/Moose/Manual/Roles.pod
@@ -253,6 +253,11 @@ 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 attributes (such as reader, writer,
+clearer, or predicate methods) cannot be C<alias>ed or C<exclude>d.
+They are composed into the class's namespace, not the role's.
+L<MooseX::AttributeHelpers>-generated methods are similarly affected.
+
 =head1 ROLE EXCLUSION
 
 A role can say that it cannot be combined with some other role. This