review_comments

Author: IsmathBadsha

posts/2026-03-10-26.0.0.3-beta.adoc

@@ -25,6 +25,8 @@ The link:{url-about}[Open Liberty] 26.0.0.3-beta includes the following beta fea
 * <<encoders, Encode responses with ContentEncoder and ToolResponseEncoder>>
 * <<requestid, Access the request ID from a tool>>
 
+The link:https://modelcontextprotocol.io/docs/getting-started/intro[Model Context Protocol (MCP)] is an open standard that enables AI applications to access real-time information from external sources. The Liberty MCP Server feature (`mcpServer-1.0`) allows developers to expose the business logic of their applications, allowing it to be integrated into agentic AI workflows.
+
 See also link:{url-prefix}/blog/?search=beta&key=tag[previous Open Liberty beta blog posts].
 
 // // // // DO NOT MODIFY THIS COMMENT BLOCK <GHA-BLOG-TOPIC> // // // // 
@@ -34,14 +36,12 @@ See also link:{url-prefix}/blog/?search=beta&key=tag[previous Open Liberty beta
 [#encoders]
 == Encode responses with ContentEncoder and ToolResponseEncoder
 
-The link:https://modelcontextprotocol.io/docs/getting-started/intro[Model Context Protocol (MCP)] is an open standard that enables AI applications to access real-time information from external sources. The Liberty MCP Server feature (`mcpServer-1.0`) allows developers to expose the business logic of their applications, allowing it to be integrated into agentic AI workflows.
-
 When a client calls a tool, the object that is returned by the tool method is converted to a `ToolResponse`, which usually contains one or more `Content` objects. The `ToolResponse` maps directly to the result returned in the response.
 
 If you need more control over the response from your tool, you can return a `ToolResponse` or `Content` object directly. Now it is also possible to register encoders to control how other objects are converted into a response.
 
 * Use `ToolResponseEncoder` to convert an object into a `ToolResponse`, which gives you complete control over the whole response.
-* Use `ContentEncoder` only when you need to convert an object into a `Content` that is included in the response. You can also return a list of objects, and each object is individually converted into a `Content` and included in the response.
+* Use `ContentEncoder` when you only need to convert an object into a `Content` that is included in the response. You can also return a list of objects, and each object is individually converted into a `Content` and included in the response.
 
 If a tool method returns an object for which no encoder is provided, JSON-B encodes the object as JSON, which is returned as text content.