Address review suggestions

examples/anydata-to-yaml-string/any_data_to_yaml_string.metatags

@@ -1,2 +1,2 @@
-description: This BBE demonstrates how to convert a subtype of `anydata` value to a YAML format string.
+description: This BBE demonstrates how to serialize a value belonging to `anydata` to a string in YAML format.
 keywords: ballerina, ballerina by example, BBE, yaml, yaml to string, record to yaml

examples/anydata-to-yaml-string/anydata_to_yaml_string.md

@@ -1,4 +1,4 @@
-# Anydata to YAML string conversion
+# Serialize a Ballerina value to a string in YAML format
 
 The `data.yaml` library provides the `toYamlString` function to convert a value belonging to `anydata` to a string in YAML format.
 

examples/index.json

@@ -790,7 +790,7 @@
   },
   {
     "title": "Tables",
-    "column": 2,
+    "column": 1,
     "category": "Language concepts",
     "samples": [
       {
@@ -4639,7 +4639,7 @@
         "isLearnByExample": true
       },
       {
-        "name": "Anydata to YAML string",
+        "name": "Serialize a Ballerina value to a string in YAML format",
         "url": "anydata-to-yaml-string",
         "verifyBuild": true,
         "verifyOutput": true,

examples/yaml-to-anydata-with-projection/yaml_to_anydata_with_projection.bal

@@ -14,9 +14,8 @@ type DatabaseConfig record {|
 |};
 
 public function main() returns error? {
-    // Can read from a file as well.
-    string yamlString = string
-        `
+    // Similar to content read from a YAML file.
+    string yamlString = string `
         host: "localhost"
         port: 8080
         remotePorts: [9000, 9001, 9002, 9003]

examples/yaml-to-anydata-with-projection/yaml_to_anydata_with_projection.md

@@ -1,12 +1,12 @@
 # YAML to anydata conversion with projection
 
-The `data.yaml` library provides multiple APIs to selectively convert elements and attributes from a YAML source, 
+The `data.yaml` library provides multiple APIs to selectively parse elements and attributes from a YAML source, 
 in the form of a string, byte array, or byte block stream, into a Ballerina record. 
-Using projection, users can selectively add attributes to records and limit the sizes of arrays. 
+Using projection, users can selectively add attributes to records and limit the sizes of arrays.
+
 In this example, the `password` attribute is excluded when creating the `DatabaseConfig` record, 
 and only the first two elements from the source are used to create the `remotePorts` array.
 
-
 For more information on the underlying module, see the [`data.yaml` module](https://lib.ballerina.io/ballerina/data.yaml/latest/).
 
 ::: code yaml_to_anydata_with_projection.bal :::

examples/yaml-to-anydata/yaml_to_anydata.bal

@@ -24,15 +24,15 @@ public function main() returns error? {
     ServerConfig serverConfig2 = check yaml:parseBytes(yamlByteArr);
     io:println(serverConfig2);
 
-    stream<byte[], error?> byteBlockStream = new (new StreamImplementor(yamlString));
+    stream<byte[], error?> byteBlockStream = new (new ByteBlockGenerator(yamlString));
     // Parse the YAML byte block stream to a record type.
     ServerConfig serverConfig3 = check yaml:parseStream(byteBlockStream);
     io:println(serverConfig3);
 }
 
-// Defines a class called `StreamImplementor`, which implements the `next()` method.
+// Defines a class called `ByteBlockGenerator`, which is stream implementer with `next()` method.
 // This will be invoked when the `next()` method of the stream gets invoked.
-class StreamImplementor {
+class ByteBlockGenerator {
     private int index = 0;
     private final byte[] byteArr;
     private final int arraySize;

examples/yaml-to-anydata/yaml_to_anydata.md

@@ -1,7 +1,6 @@
 # YAML to anydata conversion
 
-The `data.yaml` library provides multiple APIs to perform the conversion from YAML source, which can be provided as a `string`, `byte array`, or `byte block stream`, 
-into a subtype of Ballerina `anydata`.
+The `data.yaml` library provides multiple APIs to parse YAML source, in the form of a string, byte array, or byte block stream, into a subtype of Ballerina `anydata`.
 
 For more information on the underlying module, see the [`data.yaml` module](https://lib.ballerina.io/ballerina/data.yaml/latest/).