Address comments

Author: yasmewad

docs/source-2.0/additional-specs/ai-traits.rst

@@ -47,7 +47,7 @@ Each prompt template definition consists of the following components:
 
 
 Template Placeholder Syntax
-============================
+===========================
 
 Prompt templates use ``{{parameterName}}`` syntax to reference parameters from the associated ``arguments`` structure. This can be useful to reference and interpolate members of arguments when accepting user input for prompts in Model Context Protocol (MCP) servers.
 
@@ -118,7 +118,7 @@ Service-level vs operation-level prompts
 
 
 Use cases for prompts
-=======================
+=====================
 
 Service authors can define sophisticated workflows by defining prompts to orchestrate multiple API calls and format results.
 
@@ -157,9 +157,8 @@ Prompts can guide LLMs to perform complex workflows using existing operations:
         destinationLocation: String
     }
 
-
 A complete example
-=====================
+==================
 
 The following example demonstrates creative prompt templates that enhance the user experience with a weather service:
 
@@ -223,11 +222,10 @@ The following example demonstrates creative prompt templates that enhance the us
         location2: String
     }
 
-
 Integration with Model Context Protocol
 =======================================
 
-The ``smithy.ai#prompts`` trait is designed to work with Model Context Protocol (MCP) servers. MCP servers can use the metadata defined in the trait to generate _prompts:https://modelcontextprotocol.io/specification/2025-06-18/server/prompts  as defined in the Model Context Protocol (MCP) specification.
+The ``smithy.ai#prompts`` trait is designed to work with Model Context Protocol (MCP) servers. MCP servers can use the metadata defined in the trait to generate   `prompts`_  as defined in the Model Context Protocol (MCP) specification.
 
 See also
     - `MCP Server Example`_ for a complete implementation of an MCP server using Smithy
@@ -237,3 +235,4 @@ See also
 .. _MCP Server Example: https://github.com/smithy-lang/smithy-java/tree/main/examples/mcp-server
 .. _MCP Traits Example: https://github.com/smithy-lang/smithy-java/tree/main/examples/mcp-traits-example
 .. _MCP Server Model: https://github.com/smithy-lang/smithy-java/blob/main/examples/mcp-server/src/main/resources/software/amazon/smithy/java/example/server/mcp/main.smithy
+.. _Prompts: https://modelcontextprotocol.io/specification/2025-06-18/server/prompts