Add Self Validation section to README.md and User Guide

README.md

@@ -63,6 +63,26 @@ templatetool --silent --log output.log
 | `--results <file>`   | Write validation results to file (TRX or JUnit format)       |
 | `--log <file>`       | Write output to log file                                     |
 
+## Self Validation
+
+Running `templatetool --validate` reports system information and then prints each test
+name with its pass or fail result:
+
+| Information    | Description                                      |
+| :------------- | :----------------------------------------------- |
+| Tool Version   | The version of the tool being validated          |
+| Machine Name   | The name of the machine running the validation   |
+| OS Version     | The operating system version                     |
+| DotNet Runtime | The .NET runtime version                         |
+| Time Stamp     | The UTC date and time of the validation run      |
+
+The following self-validation tests prove:
+
+- **`TemplateTool_VersionDisplay`** - `--version` outputs a valid version string.
+- **`TemplateTool_HelpDisplay`** - `--help` outputs usage and options information.
+
+See the [User Guide][link-guide] for more details on the self-validation tests.
+
 ## Documentation
 
 Generated documentation includes:
@@ -99,3 +119,4 @@ By contributing to this project, you agree that your contributions will be licen
 [link-quality]: https://sonarcloud.io/dashboard?id=demaconsulting_TemplateDotNetTool
 [link-security]: https://sonarcloud.io/dashboard?id=demaconsulting_TemplateDotNetTool
 [link-nuget]: https://www.nuget.org/packages/DemaConsulting.TemplateDotNetTool
+[link-guide]: https://github.com/demaconsulting/TemplateDotNetTool/blob/main/docs/guide/guide.md

docs/guide/guide.md

@@ -57,6 +57,16 @@ templatetool --validate --results results.trx
 The results file format is determined by the file extension: `.trx` for TRX (MSTest) format,
 or `.xml` for JUnit format.
 
+## Self-Validation Tests
+
+The self-validation verifies the tool is functioning correctly in the deployment environment.
+The following tests are performed:
+
+| Test Name                     | Proves                                                |
+| ----------------------------- | ----------------------------------------------------- |
+| `TemplateTool_VersionDisplay` | `--version` outputs a valid version string            |
+| `TemplateTool_HelpDisplay`    | `--help` outputs usage and options information        |
+
 ## Silent Mode
 
 Suppress console output: