Minor upgrades and updated docs for ToolDescriptionEvaluator (#1016)

* Updated special character handling

* Removed unnecessary log messages

* Updated docs and env variable handling

* Re-ran the utility

* Applied PR feedback and updated space replacement character

* Re-ran the utility

* Updated single tool validation logic

* Fixed escaping issues and updated results

* Added a new build task for ToolDescriptionEvaluator

* Applied PR feedback

Author: vcolin7

.github/PULL_REQUEST_TEMPLATE.md

@@ -20,7 +20,7 @@
     - [ ] Updated `README.md` documentation
     - [ ] Updated command list in `/docs/azmcp-commands.md`
     - [ ] Updated test prompts in `/docs/e2eTestPrompts.md`
-    - [ ] For new or modified tool descriptions, ran the `eng/tools/ToolDescriptionEvaluator` tool and obtained a result >= 0.4
+    - [ ] For new or modified tool descriptions, ran [`ToolDescriptionEvaluator`](https://github.com/Azure/azure-mcp/blob/main/eng/tools/ToolDescriptionEvaluator/Quickstart.md) and obtained a score of `0.4` or more and a top 3 ranking for all related test prompts
 - [ ] 👉 For Community (non-Azure team member) PRs:
     - [ ] **Security review**: Reviewed code for security vulnerabilities, malicious code, or suspicious activities before running tests (`crypto mining, spam, data exfiltration, etc.`)
     - [ ] **Manual tests run**: added comment `/azp run azure - mcp` to run *Live Test Pipeline*

.vscode/tasks.json

@@ -14,20 +14,16 @@
 			"problemMatcher": "$msCompile"
 		},
 		{
-			"label": "build",
-			"type": "shell",
+			"label": "build ToolDescriptionEvaluator",
 			"command": "dotnet",
+			"type": "process",
 			"args": [
 				"build",
-				"${workspaceFolder}/AzureMcp.sln",
+				"${workspaceFolder}/eng/tools/ToolDescriptionEvaluator/ToolDescriptionEvaluator.csproj",
 				"/property:GenerateFullPaths=true",
 				"/consoleloggerparameters:NoSummary"
 			],
-			"isBackground": false,
-			"problemMatcher": [
-				"$msCompile"
-			],
-			"group": "build"
+			"problemMatcher": "$msCompile"
 		}
 	]
 }

CONTRIBUTING.md

@@ -144,7 +144,7 @@ The project is organized as follows:
    - Include tests in the `/tests` folder
    - Ensure all tests pass
    - Follow code style requirements
-   - Run the `eng/tools/ToolDescriptionEvaluator` tool for the new tool description and ensure a result >= 0.4 is achieved
+   - Run [`ToolDescriptionEvaluator`](https://github.com/Azure/azure-mcp/blob/main/eng/tools/ToolDescriptionEvaluator/Quickstart.md) for the new tool description and obtain a score of `0.4` or more and a top 3 ranking for all related test prompts
 
 ## Testing
 

areas/deploy/src/AzureMcp.Deploy/Schemas/deploy-app-topology-schema.json

@@ -29,7 +29,7 @@
                     },
                     "port": {
                         "type": "string",
-                        "description": "The port number the service uses. Get this from Dockerfile for container apps. If not available, default to \u002780\u0027."
+                        "description": "The port number the service uses. Get this from Dockerfile for container apps. If not available, default to '80'."
                     },
                     "azureComputeHost": {
                         "type": "string",
@@ -44,15 +44,15 @@
                     },
                     "dockerSettings": {
                         "type": "object",
-                        "description": "Docker settings for the service. This is only needed if the service\u0027s azureComputeHost is containerapp.",
+                        "description": "Docker settings for the service. This is only needed if the service's azureComputeHost is containerapp.",
                         "properties": {
                             "dockerFilePath": {
                                 "type": "string",
-                                "description": "The absolute path to the Dockerfile for the service. If the service\u0027s azureComputeHost is not containerapp, leave blank."
+                                "description": "The absolute path to the Dockerfile for the service. If the service's azureComputeHost is not containerapp, leave blank."
                             },
                             "dockerContext": {
                                 "type": "string",
-                                "description": "The absolute path to the Docker build context for the service. If the service\u0027s azureComputeHost is not containerapp, leave blank."
+                                "description": "The absolute path to the Docker build context for the service. If the service's azureComputeHost is not containerapp, leave blank."
                             }
                         },
                         "required": [