Upgrade Guide in Docs

docs/.vitepress/config.ts

@@ -58,6 +58,7 @@ function navbar() {
     return [
         {text: 'Home', link: '/'},
         {text: 'Documentation', items: sidebar()},
+        {text: 'Upgrading', items: upgradeGuides()},
         {text: 'Creator', link: '/creator'},
     ]
 }
@@ -84,3 +85,9 @@ function sidebar() {
         },
     ]
 }
+
+function upgradeGuides() {
+    return [
+        {text: 'v1.x to v2.x', link: '/upgrade-guide/v1x-to-v2x'},
+    ]
+}

docs/upgrade-guide/v1x-to-v2x.md

@@ -0,0 +1,53 @@
+---
+title: Upgrading from v1.x to v2.x
+---
+
+# Upgrading from v1.x to v2.x
+
+[[toc]]
+
+::: info
+We attempt to document every possible breaking change. Since some of these breaking changes are in obscure parts of the
+package only a portion of these changes may actually affect your application.
+:::
+
+## High Impact Changes
+
+### Setting Gross Amount and Order ID
+
+::: danger
+Level of impact: **High**
+:::
+
+Kasir object no longer have a `transaction_details` property. Instead, it is now assigns `gross_amount` and `order_id`
+individually.
+
+If you are implementing `transactionDetails()` method to assign the `gross_amount` and `order_id` individually, you need
+to update that to `grossAmount()` and `orderId()` method respectively.
+
+Or, if you are implementing `getTransactionDetails()` method to get the `gross_amount` and `order_id` individually, you need to
+update that to `getGrossAmount()` and `getOrderId()` method respectively.
+
+```php
+class YourController extends Controller
+{
+    public function transaction(Request $request) {    
+        $kasir = Kasir::make() // [!code focus:7]
+            ->transactionDetails([ // [!code --]
+                'gross_amount' => $request->get('gross_amount'), // [!code --]
+                'order_id' => 'order-'.Str::randomUuid(), // [!code --]
+            ]); // [!code --]
+            ->grossAmount($request->get('gross_amount')) // [!code ++]
+            ->orderId('order-'.Str::randomUuid()); // [!code ++]
+
+        // [!code focus:6]
+        $gross_amount = $kasir->getTransactionDetails()['gross_amount']; // [!code --]
+        $gross_amount = $kasir->getGrossAmount(); // [!code ++]
+
+        $order_id = $kasir->getTransactionDetails()['order_id']; // [!code --]
+        $order_id = $kasir->getOrderId(); // [!code ++]
+
+        // ...
+    }
+}
+```