Added Release Highlights to Migration Guide.

Change-Id: Ib031ada0e02781c43850ad1efd3e42c94ac59d5e
Signed-off-by: Michal Gajdos <[email protected]>

Author: Michal Gajdos

docs/src/main/docbook/migration.xml

@@ -55,6 +55,65 @@
     <section xml:id="mig-2.9">
         <title>Migrating from Jersey 2.8 to 2.9</title>
 
+        <section xml:id="mig-2.9-highlights">
+            <title>Release 2.9 Highlights</title>
+
+            <section>
+                <title>Declarative Linking</title>
+
+                <para>
+                    Gerard updated the Declarative Linking extension module which has been ported to Jersey 2 in version 2.6. You
+                    can read more about what Declarative Linking does and what it's capable of in the following blog posts:
+
+                    <itemizedlist>
+                        <listitem>
+                            <para>
+                                <link xlink:href='http://kingsfleet.blogspot.co.uk/2014/05/declarative-linking-in-jersey-29.html'>Declarative Linking in Jersey 2.9 and up</link>
+                            </para>
+                        </listitem>
+                        <listitem>
+                            <para>
+                                <link xlink:href='http://kingsfleet.blogspot.co.uk/2014/05/reading-and-writing-jax-rs-link-objects.html'>Reading and writing JAX-RS Link objects</link>
+                            </para>
+                        </listitem>
+                    </itemizedlist>
+                </para>
+            </section>
+            <section>
+                <title>Jackson 2</title>
+
+                <para>
+                    Our media module that supports working with JSON via Jackson library has been updated to use Jackson 2.x (2.3.2).
+                    All samples and tests have been rewritten to use Jackson 2 as well. In order to use Jackson 2 in your application
+                    you need to add jersey-media-json-jackson (+ it's Jackson dependencies) to your class-path and register
+                    <literal>JacksonFeature</literal> in your application.
+                </para>
+            </section>
+            <section>
+                <title>META-INF/services</title>
+
+                <para>
+                    We dropped automatic registration of message body providers (MessageBodyWriter, MessageBodyReader) and exception
+                    mappers via META-INF/services mechanism. This functionality can be restored by adding <literal>jersey-metainf-services</literal>
+                    module to the class-path of your application.
+                </para>
+                <para>
+                    Note: This change may affect 3rd party libraries (e.g. Jackson 2.x) in a way their provider would not be
+                    registered in an JAX-RS app. You need to either register them manually or use mentioned
+                    <literal>jersey-metainf-services</literal> module.
+                </para>
+            </section>
+            <section>
+                <title>Jersey Test Framework</title>
+
+                <para>
+                    Jersey Test Framework now supports TestNG to run the tests (in addition to the JUnit, which is supported by default).
+                    You can now run the tests in parallel using either JUnit or TestNG. See chapters dedicated to TestNG and parallel
+                    testing for more information: <xref linkend="testng"/> and <xref linkend="parallel"/>.
+                </para>
+            </section>
+        </section>
+
         <section xml:id="mig-2.9-breaking-changes">
             <title>Changes</title>
             <para>