further

docs/migration-guides/v2/lib.md

@@ -1,13 +1,13 @@
 # Migration guide for ably-js v2
 
-Here’s how to migrate:
+Here’s how to migrate from ably-js v1 to v2:
 
-1. [Stop using functionality deprecated in ably-js v1](#stop-using-functionality-deprecated-in-ably-js-v1)
-1. [Update to ably-js v2 and address any non-deprecation breaking changes in v2](#update-to-ably-js-v2-and-address-any-non-deprecation-breaking-changes-in-v2).
-1. (optional) [Stop using functionality that v2 deprecates](#stop-using-functionality-that-v2-deprecates).
-1. (optional) [Take advantage of new features that v2 introduces](#take-advantage-of-new-features-that-v2-introduces).
+1. [Stop using functionality that v1 deprecated](#stop-using-functionality-that-v1-deprecated).
+1. [Update to v2 and handle its breaking changes](#update-to-v2-and-handle-its-breaking-changes).
+1. (Optional) [Stop using functionality that v2 deprecates](#stop-using-functionality-that-v2-deprecates).
+1. (Optional) [Take advantage of new features that v2 introduces](#take-advantage-of-new-features-that-v2-introduces).
 
-## Stop using functionality deprecated in ably-js v1
+## Stop using functionality that v1 deprecated
 
 TODO First update to ably-js 1.2.50 or later
 
@@ -46,7 +46,7 @@ In ably-js 1.2.50 or later, use of the following APIs will trigger a deprecation
 - [Remove public ChannelModes type](https://github.com/ably/ably-js/commit/04f0f16427c0caab9799b02ee73877f6b71e5ded)
 - [Remove duplicate type names](https://github.com/ably/ably-js/commit/f7e28aa029a64f178c2996c668f4bab878033c03)
 
-## Update to ably-js v2 and address any non-deprecation breaking changes in v2
+## Update to v2 and handle its breaking changes
 
 The changes below are split into those that affect all users, and those that only affect TypeScript users.