Merge pull request #9456 from DimuthuMadushan/doc-imp

Update GraphQL vs Apollo comparison

components/integration/ballerina-vs-apollo-for-graphql/code/apollo-graphql-bbe/better-security.md

@@ -1,6 +1,6 @@
 ---
 title: 'Better security'
-description: 'Ballerina provides robust security features such as encryption, authentication, and authorization, which are essential for businesses dealing with sensitive data.'
+description: 'Ballerina offers robust security features like encryption, authentication, and authorization, essential for businesses handling sensitive data. It also ensures query integrity with depth validation and complexity analysis.'
 url: 'https://github.com/ballerina-guides/integration-samples/blob/graphql-security/graphql-social-media-service/service.bal'
 ---
 ```
@@ -30,10 +30,19 @@ listener graphql:Listener graphqlListener = new (9090,
             scopes: ["admin"]
         }
     ],
-    // Validate the query depth
-    maxQueryDepth: 5
+    // Validate the query depth.
+    maxQueryDepth: 5,
+    queryComplexityConfig: {
+        // Limit the complexity of the query being executed.
+        maxComplexity: 50
+    }
 }
 service /graphql on graphqlListener {
+
+    @graphql:ResourceConfig {
+        // Define complexity for the field.
+        complexity: 10
+    }
     resource function get users() returns User[] {
         // ...
     }
@@ -43,7 +52,7 @@ service /graphql on graphqlListener {
 }
 
 public type NewPost readonly & record {|
-    // Validate user inputs
+    // Validate user inputs.
     @constraint:String {
         maxLength: 25,
         minLength: 5

components/integration/ballerina-vs-apollo-for-graphql/code/apollo-graphql-bbe/cli-tool.md

@@ -1,6 +1,6 @@
 ---
 title: "GraphQL CLI tool - An all-in-one tool for GraphQL"
-description: "Experience the exhilaration of the Ballerina GraphQL CLI tool. Effortlessly generate custom GraphQL clients from schemas, accessing endpoints with ease. Seamlessly generate and share Ballerina GraphQL service schemas, facilitating collaboration and empowering efficient development workflows."
+description: "Discover the Ballerina GraphQL CLI tool. Easily generate custom GraphQL clients from schemas and access endpoints. Create and share Ballerina GraphQL service schemas to streamline collaboration and development workflows."
 image: 'images/usecases/integration/apollo-graphql/graphql-cli-tool.png'
 url: 'https://ballerina.io/learn/graphql-tool/'
 ---

components/integration/ballerina-vs-apollo-for-graphql/code/apollo-graphql-bbe/designer-tool.md

@@ -1,6 +1,6 @@
 ---
 title: "Built-in designer tool for GraphQL"
-description: "Explore the boundless possibilities with the in-built GraphQL API designer, a visual tool of the Ballerina VS Code plugin. Effortlessly design and prototype GraphQL APIs, unlocking a seamless and intuitive development experience. Empower your GraphQL services with this exceptional visual designer tool."
+description: "Explore the built-in GraphQL API designer, a visual tool made available via the Ballerina VS Code plugin. Easily design and prototype GraphQL APIs for a smooth development experience. Use this visual tool to understand and explain your GraphQL services better."
 image: "images/usecases/integration/apollo-graphql/graphql-diagram-editor.png"
 url: "https://wso2.com/ballerina/vscode/docs/design-the-services/graphql-api-designer/"
 ---

components/integration/ballerina-vs-apollo-for-graphql/code/apollo-graphql-bbe/similarities.md

@@ -1,4 +1,4 @@
 ---
 title: "Ballerina is GraphQL - GraphQL is Ballerina"
-description: "Ballerina, a strongly-typed language, is perfectly suited for GraphQL's declarative data fetching. With compile-time error handling, Ballerina ensures reliability and efficiency, making it an excellent choice for building robust and user-friendly GraphQL APIs. Ballerina is the perfect choice for developers who want to build reliable, efficient, and easy-to-use GraphQL APIs. The similarities between the Ballerina and GraphQL syntax are astonishing."
+description: "Ballerina, a strongly-typed language, is perfectly suited for GraphQL's declarative data fetching. With compile-time error handling, Ballerina ensures reliability and efficiency, making it an excellent choice for building robust and user-friendly GraphQL APIs. The similarity between Ballerina and GraphQL syntax enhances the development experience. Ballerina is an ideal choice for developers looking to build reliable, efficient, and intuitive GraphQL APIs."
 ---