edits per review

#7661
OpenLiberty · Jan 17, 2025 · 6e22d41 · 6e22d41
1 parent a92c4c3
commit 6e22d41
Showing 1 changed file with 2 additions and 2 deletions.
diff --git a/modules/ROOT/pages/rest-alternatives.adoc b/modules/ROOT/pages/rest-alternatives.adoc
@@ -15,9 +15,9 @@
 
 Although REST is a widely adopted pattern for communications among microservices, Open Liberty supports alternative options that might be better suited for some application scenarios. These alternatives include GraphQL, gRPC, and WebSocket.
 
-REST comes with tradeoffs in capability and performance that can make it a less than ideal solution for some use cases. Issues such as over-fetching and under-fetching of data, lack of real-time communication, and tight coupling between client and server can lead to performance and maintenance concerns for certain types of applications. To address these issues, you can use alternative protocols and frameworks that specifically address the shortcomings of REST.
+REST is by far the most common architectural style for microservices, thanks to its simplicity, flexibility, and scalability. However, it comes with tradeoffs that can make it a less than ideal solution for some use cases. Issues such as over-fetching and under-fetching of data, lack of real-time communication, and tight coupling between client and server can lead to performance and maintenance concerns for certain types of applications. To address these issues, you can use alternative protocols and frameworks that specifically address the shortcomings of REST.
 
-* xref:microprofile-graphql.adoc[GraphQL]: This open source data query and manipulation language for APIs directly addresses problems with over-fetching and under-fetching of data that might occur with REST APIs.
+* xref:microprofile-graphql.adoc[GraphQL]: This open source query language and runtime can simplify retrieving data from multiple sources, such as APIs, databases, and other services. It directly addresses problems with over-fetching and under-fetching of data that might occur with REST APIs.
 * xref:web-socket.adoc[WebSocket]: This protocol enables real-time bidirectional communication between a server and one or more clients, which is not feasible in REST architecture.
 * xref:grpc-services.adoc[gRPC]: This framework provides efficient data serialization and multiplexing capabilities for high-performance applications that require high throughput and low latency. It also enables efficient communication between services and applications in various languages and platforms.