It might make sense to somehow highlight paragraphs/sentences which describe new behaviour/features in CDI 1.1. There's currently cca 15-20 of those.
Maybe a note/tip/important box like this:
<note><title>New in CDI 1.1</title><para>
The <literal>beans.xml</literal> file is no longer required for CDI
enablement as of CDI 1.1. CDI is automatically enabled for archives
which don't contain <literal>beans.xml</literal> but contain one or
more bean classes with a <emphasis>bean defining annotation</emphasis>,
as described in section <xref linkend="implicit-bean-archive"/>.
</para></note>
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira