Add review comments

examples/index.json

@@ -4264,9 +4264,9 @@
     ]
   },
   {
-    "title": "Reading data",
+    "title": "Query data",
     "column": 0,
-    "category": "Persistence",
+    "category": "Bal persist",
     "samples": [
       {
         "name": "Get all",
@@ -4296,7 +4296,7 @@
         "isLearnByExample": false
       },
       {
-        "name": "Filtering and sorting",
+        "name": "Filter and sort",
         "url": "persist-filtering",
         "verifyBuild": false,
         "verifyOutput": false,
@@ -4316,9 +4316,9 @@
     ]
   },
   {
-    "title": "Writing data",
+    "title": "Write data",
     "column": 1,
-    "category": "Persistence",
+    "category": "Bal persist",
     "samples": [
       {
         "name": "Create/Create many",

examples/persist-create/persist_create.md

@@ -24,7 +24,7 @@ Execute the command below to generate the Ballerina client API.
 
 #### Use the generated client API
 
-Using the generated client API, you can persist record/records to the datastore with the `post` resource method.
+Using the generated client API, you can persist record/records to the data store with the `post` resource method.
 
 ::: code persist_create.bal :::
 

examples/persist-create/persist_create.metatags

@@ -1,2 +1,2 @@
 description: This BBE demonstrates the usage of post resource method in the generated persistence client to persist record/records to the data store
-keywords: ballerina, ballerina by example, bbe, persistence, datastore, post, entity
+keywords: ballerina, ballerina by example, bbe, persistence, data store, post, entity

examples/persist-delete/persist_create.metatags

@@ -1,2 +1,2 @@
 description: This BBE demonstrates the usage of delete resource method in the generated persistence client to delete record from the data store.
-keywords: ballerina, ballerina by example, bbe, persistence, datastore, delete, entity
+keywords: ballerina, ballerina by example, bbe, persistence, data store, delete, entity

examples/persist-delete/persist_delete.md

@@ -24,7 +24,7 @@ Execute the command below to generate the Ballerina client API.
 
 #### Use the generated client API
 
-Using the generated client API, you can delete records from the datastore with the `delete` resource method.
+Using the generated client API, you can delete records from the data store with the `delete` resource method.
 
 ::: code persist_delete.bal :::
 

examples/persist-filtering/persist_filtering.md

@@ -1,4 +1,4 @@
-# Persist read - Filtering and sorting
+# Persist read - Filter and sort
 
 The bal persist feature provide support to manage data persistence in a Ballerina package. It starts with defining the application's data model. Once model is defined, the client API is generated with resources based on the model. The generated
 API can be used to query and manipulate the persistent data in the application.
@@ -24,7 +24,7 @@ Execute the command below to generate the Ballerina client API.
 
 #### Use the generated client API
 
-Using the generated client API, we can retrieve all records from the datastore. The `get` resource method returns a stream of records. We can iterate through the stream and print the records.
+Using the generated client API, we can retrieve all records from the data store. The `get` resource method returns a stream of records. We can iterate through the stream and print the records.
 
 ::: code persist_filtering.bal :::
 

examples/persist-filtering/persist_filtering.metatags

@@ -1,2 +1,2 @@
 description: This BBE demonstrates the usage of query expressions with get resource method in generated persistence client.
-keywords: ballerina, ballerina by example, bbe, persistence, datastore, get, entity, filtering, query
+keywords: ballerina, ballerina by example, bbe, persistence, data store, get, entity, filtering, query

examples/persist-get-all/persist_get_all.metatags

@@ -1,2 +1,2 @@
 description: This BBE demonstrates the usage of get resource method in generated persistence client.
-keywords: ballerina, ballerina by example, bbe, persistence, datastore, get, entity
+keywords: ballerina, ballerina by example, bbe, persistence, data store, get, entity

examples/persist-get-by-key/persist_get_by_key.md

@@ -24,7 +24,7 @@ Execute the command below to generate the Ballerina client API.
 
 #### Use the generated client API
 
-Using the generated client API, you can retrieve the record by key from the datastore. The `get by key` resource method returns a record or error if no records are found for the given key.
+Using the generated client API, you can retrieve the record by key from the data store. The `get by key` resource method returns a record or error if no records are found for the given key.
 
 ::: code persist_get_by_key.bal :::
 

examples/persist-get-by-key/persist_get_by_key.metatags

@@ -1,2 +1,2 @@
 description: This BBE demonstrates the usage of get by key resource method in generated persistence client.
-keywords: ballerina, ballerina by example, bbe, persistence, datastore, get by key, entity
+keywords: ballerina, ballerina by example, bbe, persistence, data store, get by key, entity

examples/persist-relation-queries/persist_relation_queries.md

@@ -24,7 +24,7 @@ Execute the command below to generate the Ballerina client API.
 
 #### Use the generated client API
 
-Using the generated client API, you can retrieve the record with relation fields from the datastore with both `get` and `get by key` resource methods.
+Using the generated client API, you can retrieve the record with relation fields from the data store with both `get` and `get by key` resource methods.
 
 ::: code persist_relation_queries.bal :::
 

examples/persist-relation-queries/persist_relation_queries.metatags

@@ -1,2 +1,2 @@
-description: This BBE demonstrates the usage of the get/get by key resource method in generated persistence client to retrieve relation fields of an entity from the datastore.
-keywords: ballerina, ballerina by example, bbe, persistence, datastore, get by key, get, select, entity, relations
+description: This BBE demonstrates the usage of the get/get by key resource method in generated persistence client to retrieve relation fields of an entity from the data store.
+keywords: ballerina, ballerina by example, bbe, persistence, data store, get by key, get, select, entity, relations

examples/persist-select-fields/persist_select_fields.md

@@ -24,7 +24,7 @@ Execute the command below to generate the Ballerina client API.
 
 #### Use the generated client API
 
-Using the generated client API, you can retrieve the record with selected fields from the datastore with both `get` and `get by key` resource methods.
+Using the generated client API, you can retrieve the record with selected fields from the data store with both `get` and `get by key` resource methods.
 
 ::: code persist_select_fields.bal :::
 

examples/persist-select-fields/persist_select_fields.metatags

@@ -1,2 +1,2 @@
-description: This BBE demonstrates the usage of the get/get by key resource method in generated persistence client to retrieve selected fields of an entity from the datastore.
-keywords: ballerina, ballerina by example, bbe, persistence, datastore, get by key, get, select, entity
+description: This BBE demonstrates the usage of the get/get by key resource method in generated persistence client to retrieve selected fields of an entity from the data store.
+keywords: ballerina, ballerina by example, bbe, persistence, data store, get by key, get, select, entity

examples/persist-update/persist_update.md

@@ -24,7 +24,7 @@ Execute the command below to generate the Ballerina client API.
 
 #### Use the generated client API
 
-Using the generated client API, you can update the record in the datastore with the `put` resource method.
+Using the generated client API, you can update the record in the data store with the `put` resource method.
 
 ::: code persist_update.bal :::
 

examples/persist-update/persist_update.metatags

@@ -1,2 +1,2 @@
 description: This BBE demonstrates the usage of put resource method in generated persistence client to update the record in the data store.
-keywords: ballerina, ballerina by example, bbe, persistence, datastore, put, select, entity
+keywords: ballerina, ballerina by example, bbe, persistence, data store, put, select, entity