Updated migration documentation from CometD 5.
@@ -621,4 +621,80 @@ A number of deprecated APIs (since 4.0.x) have been removed.
| `Seti.PresenceListener`
|===
+[[_migration_50_to_60]]
+=== Migrating from CometD 5.0.x to CometD 6.0.x
+
+Migrating from CometD 5.0.x to CometD 6.0.x should be fairly easy, requiring mostly to take care of few APIs changes.
+
+NOTE: CometD 6.0.x is fully JPMS modularized with proper `module-info.class` descriptors.
+
+==== Required Java Version Changes
+
+[cols="1,1", options="header"]
+|===
+| CometD 5.0.x | CometD 6.0.x
+| Java 8 | Java 11
+|===
+
+==== Jetty Dependency Changes
+
+[cols="1,1", options="header"]
+|===
+| CometD 5.0.x | CometD 6.0.x
+| Jetty 9.4.x | Jetty 10.0.x
+|===
+
+==== Deprecated API Removed
+
+A number of deprecated APIs (since 5.0.x) have been removed.
+
+[cols="1a,1a", options="header"]
+|===
+| Removed in CometD 5.0.x | Replacement in CometD 6.0.x
+
+| `ServerSession.AddListener`
+| `ServerSession.Add**ed**Listener`
+
+| `ServerSession.RemoveListener`
+| `ServerSession.Remove**d**Listener`
+
+| `ServerSession.MaxQueueListener`
+| `ServerSession.MaxQueue**d**Listener`
+
+| `BayeuxServer.SessionListener.sessionRemoved(ServerSession session, boolean timeout)`
+| `BayeuxServer.SessionListener.sessionRemoved(ServerSession session, **ServerMessage message**, boolean timeout)`
+|===
+
+==== `web.xml` Changes
+
+[cols="1a,1a", options="header"]
+|===
+| CometD 5.0.x
+| CometD 6.0.x
+
+|
+[source,xml]
+----
+<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" <1>
+ version="3.1"> <2>
+ ...
+</web-app>
+----
+
+|
+[source,xml]
+----
+<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd" <1>
+ version="4.0"> <2>
+ ...
+</web-app>
+----
+<1> `schemaLocation` attribute changed from `3.1` to `4.0`
+<2> `version` attribute changed from `3.1` to `4.0`
+|===
+
:numbered:
