Enhance documentation with migration guide for version 1.0, update breaking changes section, and adjust category positions for guides and product notes.

Author: jayant-dhingra-cb

docs/Guides/Migration/v1.md

@@ -3,7 +3,7 @@ id: migration-guide-v1
 sidebar_position: 1
 ---
 
-# Migration Guide: Version 1.0
+# Version 1.0
 
 > Description — _Quick reference for all API changes in cbl-reactnative version 1.0_  
 > Related Content — [Release Notes](../../ProductNotes/release-notes.md) | [Using Logs](../../Troubleshooting/using-logs.md)
@@ -16,6 +16,29 @@ Version 1.0 introduces several API changes:
 3. **New ReplicatorConfiguration** - Collections passed in constructor
 :::
 
+## Breaking Changes
+
+### Listener Token Return Type (TypeScript)
+
+We changed all `addChangeListener` functions to return a `ListenerToken` instead of a `string`, enabling the new `token.remove()` API and aligning with other platforms.
+
+This is a breaking change **only for TypeScript code** that explicitly typed the token as `string`. JavaScript users and untyped TypeScript won't be affected.
+
+**TypeScript Migration Example:**
+
+```typescript
+// BEFORE (TypeScript compilation error in 1.0)
+const token: string = await collection.addChangeListener(listener);
+
+// AFTER
+const token: ListenerToken = await collection.addChangeListener(listener);
+token.remove();
+```
+
+The existing `removeChangeListener(token)` methods remain available for backward compatibility but are deprecated.
+
+---
+
 ## Deprecated APIs
 
 ### 1. Logging API
@@ -75,7 +98,7 @@ See: [Remote Sync](../../DataSync/remote-sync-gateway.md#example-1-replication-c
 
 ---
 
-### 3. Listener Removal Methods
+### 3. Listener Removal Methods (Deprecated)
 
 **OLD (Deprecated in 1.0):**
 ```typescript
@@ -93,27 +116,6 @@ This method is deprecated. It remains available for backward compatibility, but
 
 ---
 
-### 4. Listener Token Return Type (TypeScript)
-
-We changed all `addChangeListener` functions to return a `ListenerToken` instead of a `string`, enabling the new `token.remove()` API and aligning with other platforms.
-
-This is a small breaking change **only for TypeScript code** that explicitly typed the token as `string`. JavaScript users and untyped TypeScript won't be affected.
-
-**TypeScript Migration Example:**
-
-```typescript
-// BEFORE (TypeScript compilation error in 1.0)
-const token: string = await collection.addChangeListener(listener);
-
-// AFTER
-const token: ListenerToken = await collection.addChangeListener(listener);
-token.remove();
-```
-
-The existing `removeChangeListener(token)` methods remain available for backward compatibility but are deprecated.
-
----
-
 ## New Features in 1.0
 
 ### 1. Three Log Sink Types
@@ -234,16 +236,6 @@ await collection.removeChangeListener(token);
 await token.remove();
 ```
 
-**Step 4: Update TypeScript Token Types (Required for TypeScript)**
-
-```typescript
-// Old (compilation error)
-const token: string = await collection.addChangeListener(...);
-
-// New
-const token: ListenerToken = await collection.addChangeListener(...);
-```
-
 ---
 
 ## Important Property Names

docs/Guides/_category_.json

@@ -1,6 +1,6 @@
 {
   "label": "Guides",
-  "position": 10,
+  "position": 17,
   "collapsible": true,
   "collapsed": false
 }

docs/ProductNotes/_category_.json

@@ -1,6 +1,6 @@
 {
   "label": "Product Notes",
-  "position": 17,
+  "position": 18,
   "link": {
     "type": "generated-index",
     "description": "Learn more about releases, compatibility, and supported platforms."

docs/ProductNotes/release-notes.md

@@ -18,7 +18,7 @@ New Features:
 - Replicator Document Change Listeners - Track individual document replication
 - New ReplicatorConfiguration API - Collections passed during initialization using CollectionConfiguration
 - Collection.fullName() method - Get fully qualified collection name (scope.collection)
-- Couchbase Lite 3.3.0 - Updated iOS and Android SDKs to latest stable version
+- Couchbase Lite 3.3.0 - Updated iOS and Android SDKs to Couchbase Lite 3.3.0
 
 Breaking Changes:
 - TypeScript: ListenerToken type changed from string to ListenerToken object (affects explicitly typed code only)

docs/intro.md

@@ -50,6 +50,10 @@ Couchbase Lite for React Native is a community provided solution that is activel
 * Encryption
 	- Full Database 
 
+## Upgrading from 0.6.x?
+
+See the [Migration Guide](Guides/Migration/v1.md) for detailed instructions on upgrading to version 1.0.
+
 ## Limitations
 Some of the features supported by other platform implementations of Couchbase Lite are currently not supported: