Update README.md according to #40

README.md

@@ -129,7 +129,7 @@ $connection->table('your-table')->...
 
 ## Sample data
 
-Many of the example codes in this document are querying to [DynamoDB's official sample data](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/SampleData.LoadData.html). If you want to try these codes with actual DynamoDB tables, it's handy to load them to your tables before.
+Many of the example codes in this document are querying to [DynamoDB's official sample data](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/AppendixSampleTables.html). If you want to try these codes with actual DynamoDB tables, it's handy to load them to your tables before.
 
 ## Model
 
@@ -224,18 +224,13 @@ You also can override the `scan()` method to fit your needs, such as filtering m
 ```php
 public static function scan($exclusiveStartKey = null, $sort = 'asc', $limit = 50)
 {
- $products = static::index('GSI1')
- ->keyCondition('GSI1PK', '=', 'PRODUCT#')
- ->keyCondition('GSI1SK', 'begins_with', 'PRODUCT#')
- ->exclusiveStartKey($exclusiveStartKey)
- ->scanIndexForward($sort == 'desc' ? false : true)
- ->limit($limit)
- ->query();
-
- return [
- 'items' => $products,
- 'LastEvaluatedKey' => $products->first()->meta()['LastEvaluatedKey'] ?? null,
- ];
+ return static::index('GSI1')
+ ->keyCondition('GSI1PK', '=', 'PRODUCT#')
+ ->keyCondition('GSI1SK', 'begins_with', 'PRODUCT#')
+ ->exclusiveStartKey($exclusiveStartKey)
+ ->scanIndexForward($sort == 'desc' ? false : true)
+ ->limit($limit)
+ ->query();
 }
 ```
 
@@ -339,16 +334,16 @@ For example:
 
 ```php
 Thread::keyCondition('ForumName', '=', 'Amazon DynamoDB')
-  ->keyCondition('Subject', 'begins_with', 'DynamoDB')
-  ->filter('Views', '=', 0)
-  ->query();
+ ->keyCondition('Subject', 'begins_with', 'DynamoDB')
+ ->filter('Views', '=', 0)
+ ->query();
 ```
 
 Please refer to [Query Builder](#query-builder) for the details.
 
 ## Authentication with model
 
-We can create a Custom User Provider to authenticate with DynamoDB. For the detail, please refer to [Laravel's official document](https://laravel.com/docs/8.x/authentication#adding-custom-user-providers).
+We can create a Custom User Provider to authenticate with DynamoDB. For the detail, please refer to [Laravel's official document](https://laravel.com/docs/authentication#adding-custom-user-providers).
 
 To use authentication with the model, the model should implement `Illuminate\Contracts\Auth\Authenticatable` contract. In this section, we'll use the example `User` model above.
 
@@ -460,7 +455,6 @@ $connection = new Kitar\Dynamodb\Connection([
 ]);
 
 $result = $connection->table('Thread')->scan();
-
 ```
 
 If we query through the model, we don't need to specify the table name, and the response will be the model instance(s).
@@ -475,7 +469,7 @@ $threads = Thread::scan();
 
 ```php
 $response = DB::table('ProductCatalog')
-  ->getItem(['Id' => 101]);
+ ->getItem(['Id' => 101]);
 ```
 
 > Instead of marshaling manually, pass a plain array. `Kitar\Dynamodb\Query\Grammar` will automatically marshal them before querying.
@@ -529,8 +523,8 @@ We can specify Projection Expressions in the same manner as the original `select
 
 ```php
 $response = DB::table('ProductCatalog')
-  ->select('Price', 'Title')
-  ->getItem(['Id' => 101]);
+ ->select('Price', 'Title')
+ ->getItem(['Id' => 101]);
 ```
 
 ### Condition Expressions
@@ -574,20 +568,20 @@ DB::table('ProductCatalog')
 
 ```php
 ProductCatalog::key(['Id' => 101])
-  ->conditionIn('ProductCategory', ['Book', 'Bicycle'])
-  ->updateItem([
-  'Description' => 'updated!'
-  ]);
+ ->conditionIn('ProductCategory', ['Book', 'Bicycle'])
+ ->updateItem([
+ 'Description' => 'updated!'
+ ]);
 ```
 
 #### conditionBetween()
 
 ```php
 ProductCatalog::key(['Id' => 101])
-  ->conditionBetween('Price', [0, 10])
-  ->updateItem([
-  'Description' => 'updated!'
-  ]);
+ ->conditionBetween('Price', [0, 10])
+ ->updateItem([
+ 'Description' => 'updated!'
+ ]);
 ```
 
 ### Working with Queries
@@ -602,18 +596,18 @@ We can use some comparison operators for sort key, but we must use the equality
 
 ```php
 $response = DB::table('Thread')
-  ->keyCondition('ForumName', '=', 'Amazon DynamoDB')
-  ->keyCondition('Subject', 'begins_with', 'DynamoDB')
-  ->query();
+ ->keyCondition('ForumName', '=', 'Amazon DynamoDB')
+ ->keyCondition('Subject', 'begins_with', 'DynamoDB')
+ ->query();
 ```
 
 #### keyConditionBetween()
 
 ```php
 $response = DB::table('Thread')
-  ->keyCondition('ForumName', '=', 'Amazon DynamoDB')
-  ->keyConditionBetween('Subject', ['DynamoDB Thread 1', 'DynamoDB Thread 2'])
-  ->query();
+ ->keyCondition('ForumName', '=', 'Amazon DynamoDB')
+ ->keyConditionBetween('Subject', ['DynamoDB Thread 1', 'DynamoDB Thread 2'])
+ ->query();
 ```
 
 #### Sort order
@@ -622,9 +616,9 @@ $response = DB::table('Thread')
 
 ```php
 $response = DB::table('Thread')
-  ->keyCondition('ForumName', '=', 'Amazon DynamoDB')
-  ->scanIndexForward(false)
-  ->query();
+ ->keyCondition('ForumName', '=', 'Amazon DynamoDB')
+ ->scanIndexForward(false)
+ ->query();
 ```
 
 > Note that DynamoDB's `ScanIndexForward` is a feature for `query`. It will not work with `scan`.
@@ -647,42 +641,42 @@ It can't reduce the amount of read capacity, but it can reduce the size of traff
 
 ```php
 $response = DB::table('Thread')
-  ->filter('LastPostedBy', '=', 'User A')
-  ->scan();
+ ->filter('LastPostedBy', '=', 'User A')
+ ->scan();
 ```
 
 OR statement
 
 ```php
 $response = DB::table('Thread')
-  ->filter('LastPostedBy', '=', 'User A')
-  ->orFilter('LastPostedBy', '=', 'User B')
-  ->scan();
+ ->filter('LastPostedBy', '=', 'User A')
+ ->orFilter('LastPostedBy', '=', 'User B')
+ ->scan();
 ```
 
 AND statement
 
 ```php
 $response = DB::table('Thread')
-  ->filter('LastPostedBy', '=', 'User A')
-  ->filter('Subject', 'begins_with', 'DynamoDB')
-  ->scan();
+ ->filter('LastPostedBy', '=', 'User A')
+ ->filter('Subject', 'begins_with', 'DynamoDB')
+ ->scan();
 ```
 
 #### filterIn()
 
 ```php
 $response = DB::table('Thread')
-  ->filterIn('LastPostedBy', ['User A', 'User B'])
-  ->scan();
+ ->filterIn('LastPostedBy', ['User A', 'User B'])
+ ->scan();
 ```
 
 #### filterBetween()
 
 ```php
 $response = DB::table('ProductCatalog')
-  ->filterBetween('Price', [0, 100])
-  ->scan();
+ ->filterBetween('Price', [0, 100])
+ ->scan();
 ```
 
 ### Paginating the Results
@@ -695,8 +689,8 @@ If there are more results, the response contains `LastEvaluatedKey`.
 
 ```php
 $response = DB::table('ProductCatalog')
-  ->limit(5)
-  ->scan();
+ ->limit(5)
+ ->scan();
 
 $response['LastEvaluatedKey']; // array
 ```
@@ -705,16 +699,22 @@ We can pass this key to `exclusiveStartKey` to get next results.
 
 ```php
 $response = DB::table('ProductCatalog')
-  ->exclusiveStartKey($response['LastEvaluatedKey'])
-  ->limit(5)
-  ->scan();
+ ->exclusiveStartKey($response['LastEvaluatedKey'])
+ ->limit(5)
+ ->scan();
 ```
 
 If you are using Query Builder through model, you can access to `exclusiveStartKey` by:
 
 ```php
 $products = ProductCatalog::limit(5)->scan();
 
+$products->getLastEvaluatedKey(); // array
+```
+
+Alternatively, you can achieve the same result using individual models; however, please be aware that this approach is planned to be deprecated in versions subsequent to v2.x.
+
+```php
 $products->first()->meta()['LastEvaluatedKey']; // array
 ```
 
@@ -728,10 +728,10 @@ Use `index` clause to specify Global Secondary Index name.
 
 ```php
 $response = DB::table('Reply')
-  ->index('PostedBy-Message-index')
-  ->keyCondition('PostedBy', '=', 'User A')
-  ->keyCondition('Message', '=', 'DynamoDB Thread 2 Reply 1 text')
-  ->query();
+ ->index('PostedBy-Message-index')
+ ->keyCondition('PostedBy', '=', 'User A')
+ ->keyCondition('Message', '=', 'DynamoDB Thread 2 Reply 1 text')
+ ->query();
 ```
 
 ### Atomic Counter