Use meaningful names for markdown reference links

Replace generic link1, link2, etc. with descriptive names:
- dotnet-tools, nuspec-reference, nuget-package-creation
- github-issues, github-discussions, github-topics
- releases, usage, building-from-source
- dotnet-download, nuget-docs, github-flow
- git-commit-guide, github-security, microsoft-sdl
- owasp-secure-coding, github-security-advisories

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

Author: Copilot

AGENTS.md

@@ -5,7 +5,7 @@ This repository contains configuration and instructions for GitHub Copilot agent
 ## Repository Overview
 
 **DotnetToolWrapper** is a .NET 8.0, 9.0, and 10.0 console application that serves as a wrapper for native
-applications packaged as [.NET Tools][link1].
+applications packaged as [.NET Tools][dotnet-tools].
 
 ## Project Structure
 
@@ -131,4 +131,4 @@ Before committing:
 
 For questions or issues, please refer to the repository's issue tracker on GitHub.
 
-[link1]: https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools
+[dotnet-tools]: https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools

ARCHITECTURE.md

@@ -5,7 +5,7 @@ This document describes the architecture and design of the DotnetToolWrapper pro
 ## Overview
 
 DotnetToolWrapper is a .NET console application that serves as a universal launcher for native applications packaged
-as [.NET Tools][link1]. It enables developers to distribute
+as [.NET Tools][dotnet-tools]. It enables developers to distribute
 platform-specific native executables through the .NET tool ecosystem.
 
 ## Problem Statement
@@ -172,4 +172,4 @@ The project uses GitHub Actions for CI/CD:
 - [CONTRIBUTING.md](CONTRIBUTING.md) - Contribution guidelines
 - [SECURITY.md](SECURITY.md) - Security policy
 
-[link1]: https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools
+[dotnet-tools]: https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools

CONTRIBUTING.md

@@ -51,7 +51,7 @@ We actively welcome pull requests! To submit a pull request:
 
 ### Prerequisites
 
-- [.NET SDK 8.0 or higher][link1]
+- [.NET SDK 8.0 or higher][dotnet-download]
 - Git
 - A code editor (Visual Studio, Visual Studio Code, Rider, etc.)
 
@@ -232,15 +232,15 @@ See [LICENSE](LICENSE) for details.
 
 ## Additional Resources
 
-- [.NET Tool Documentation][link2]
-- [NuGet Package Documentation][link3]
-- [GitHub Flow][link4]
-- [Writing Good Commit Messages][link5]
+- [.NET Tool Documentation][dotnet-tools]
+- [NuGet Package Documentation][nuget-docs]
+- [GitHub Flow][github-flow]
+- [Writing Good Commit Messages][git-commit-guide]
 
 Thank you for contributing to DotnetToolWrapper! 🎉
 
-[link1]: https://dotnet.microsoft.com/download
-[link2]: https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools
-[link3]: https://learn.microsoft.com/en-us/nuget/
-[link4]: https://guides.github.com/introduction/flow/
-[link5]: https://chris.beams.io/posts/git-commit/
+[dotnet-download]: https://dotnet.microsoft.com/download
+[dotnet-tools]: https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools
+[nuget-docs]: https://learn.microsoft.com/en-us/nuget/
+[github-flow]: https://guides.github.com/introduction/flow/
+[git-commit-guide]: https://chris.beams.io/posts/git-commit/

README.md

@@ -6,7 +6,7 @@
 ![GitHub](https://img.shields.io/github/license/demaconsulting/DotnetToolWrapper?style=plastic)
 
 A .NET console application that enables native executables to be distributed as
-[.NET Tools][link1].
+[.NET Tools][dotnet-tools].
 
 ## Overview
 
@@ -34,7 +34,7 @@ dotnet tool install -g YourTool.Package
 your-tool --help
 ```
 
-Create your own wrapped tool by following the [Usage][link2] section below.
+Create your own wrapped tool by following the [Usage][usage] section below.
 
 ## Usage
 
@@ -135,7 +135,7 @@ dotnet build --configuration Release
 
 For real-world examples of tools using DotnetToolWrapper, see:
 
-- Check the [GitHub topic][link3] for projects using this wrapper
+- Check the [GitHub topic][github-topics] for projects using this wrapper
 
 ## Contributing
 
@@ -153,12 +153,12 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ## Support
 
-- **Issues**: Report bugs or request features via [GitHub Issues][link4]
-- **Discussions**: Ask questions via [GitHub Discussions][link5]
+- **Issues**: Report bugs or request features via [GitHub Issues][github-issues]
+- **Discussions**: Ask questions via [GitHub Discussions][github-discussions]
 - **Security**: Report vulnerabilities per [SECURITY.md](SECURITY.md)
 
-[link1]: https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools
-[link2]: #usage
-[link3]: https://github.com/topics/dotnettoolwrapper
-[link4]: https://github.com/demaconsulting/DotnetToolWrapper/issues
-[link5]: https://github.com/demaconsulting/DotnetToolWrapper/discussions
+[dotnet-tools]: https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools
+[usage]: #usage
+[github-topics]: https://github.com/topics/dotnettoolwrapper
+[github-issues]: https://github.com/demaconsulting/DotnetToolWrapper/issues
+[github-discussions]: https://github.com/demaconsulting/DotnetToolWrapper/discussions

SECURITY.md

@@ -22,7 +22,7 @@ report it to us as described below.
 
 Instead, please report them via GitHub's private vulnerability reporting feature:
 
-1. Navigate to the [Security tab][link1] of the repository
+1. Navigate to the [Security tab][github-security] of the repository
 2. Click "Report a vulnerability"
 3. Fill out the vulnerability report form with as much detail as possible
 
@@ -175,9 +175,9 @@ For security-related questions that are not vulnerability reports:
 
 This security policy is based on security best practices from:
 
-- [Microsoft Security Development Lifecycle][link2]
-- [OWASP Secure Coding Practices][link3]
-- [GitHub Security Advisories][link4]
+- [Microsoft Security Development Lifecycle][microsoft-sdl]
+- [OWASP Secure Coding Practices][owasp-secure-coding]
+- [GitHub Security Advisories][github-security-advisories]
 
 ## Updates to This Policy
 
@@ -189,7 +189,7 @@ We may update this security policy from time to time. We will notify users of ma
 
 Last updated: December 2024
 
-[link1]: https://github.com/demaconsulting/DotnetToolWrapper/security
-[link2]: https://www.microsoft.com/en-us/securityengineering/sdl/
-[link3]: https://owasp.org/www-project-secure-coding-practices-quick-reference-guide/
-[link4]: https://docs.github.com/en/code-security/security-advisories
+[github-security]: https://github.com/demaconsulting/DotnetToolWrapper/security
+[microsoft-sdl]: https://www.microsoft.com/en-us/securityengineering/sdl/
+[owasp-secure-coding]: https://owasp.org/www-project-secure-coding-practices-quick-reference-guide/
+[github-security-advisories]: https://docs.github.com/en/code-security/security-advisories

docs/usage.md

@@ -105,7 +105,7 @@ Create a `.nuspec` file that defines your package metadata:
 - Include `<packageType name="DotnetTool" />` to mark this as a .NET tool
 - Adjust file paths in the `<files>` section to match your structure
 
-Refer to the [.nuspec File Reference][link1] for more details.
+Refer to the [.nuspec File Reference][nuspec-reference] for more details.
 
 ### 2. Create DotnetToolSettings.xml
 
@@ -191,8 +191,8 @@ into your `tools/{framework}/any/` folder:
 
 You can obtain these files by:
 
-1. Downloading from the [releases page][link2]
-2. Building from source (see [Building from Source][link3])
+1. Downloading from the [releases page][releases]
+2. Building from source (see [Building from Source][building-from-source])
 
 ### 5. Add Your Native Executables
 
@@ -392,30 +392,30 @@ dotnet build --configuration Release
 
 For real-world examples of tools using DotnetToolWrapper:
 
-- Browse repositories on GitHub with the [dotnettoolwrapper topic][link4]
+- Browse repositories on GitHub with the [dotnettoolwrapper topic][github-topics]
 - Check the examples in the DotnetToolWrapper repository (if available)
 
 ## Support
 
-- **Issues**: Report bugs or request features via [GitHub Issues][link5]
-- **Discussions**: Ask questions via [GitHub Discussions][link6]
+- **Issues**: Report bugs or request features via [GitHub Issues][github-issues]
+- **Discussions**: Ask questions via [GitHub Discussions][github-discussions]
 - **Documentation**: See [README.md](../README.md) for project overview
 - **Architecture**: See [ARCHITECTURE.md](../ARCHITECTURE.md) for design details
 - **Contributing**: See [CONTRIBUTING.md](../CONTRIBUTING.md) for contribution guidelines
 
 ## Additional Resources
 
-- [.NET Tool Documentation][link7]
-- [.nuspec File Reference][link1]
-- [NuGet Package Creation][link8]
-- [NuGet CLI Reference][link9]
-
-[link1]: https://learn.microsoft.com/en-us/nuget/reference/nuspec
-[link2]: https://github.com/demaconsulting/DotnetToolWrapper/releases
-[link3]: #building-from-source
-[link4]: https://github.com/topics/dotnettoolwrapper
-[link5]: https://github.com/demaconsulting/DotnetToolWrapper/issues
-[link6]: https://github.com/demaconsulting/DotnetToolWrapper/discussions
-[link7]: https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools
-[link8]: https://learn.microsoft.com/en-us/nuget/create-packages/creating-a-package
-[link9]: https://learn.microsoft.com/en-us/nuget/reference/nuget-exe-cli-reference
+- [.NET Tool Documentation][dotnet-tools]
+- [.nuspec File Reference][nuspec-reference]
+- [NuGet Package Creation][nuget-package-creation]
+- [NuGet CLI Reference][nuget-cli-reference]
+
+[nuspec-reference]: https://learn.microsoft.com/en-us/nuget/reference/nuspec
+[releases]: https://github.com/demaconsulting/DotnetToolWrapper/releases
+[building-from-source]: #building-from-source
+[github-topics]: https://github.com/topics/dotnettoolwrapper
+[github-issues]: https://github.com/demaconsulting/DotnetToolWrapper/issues
+[github-discussions]: https://github.com/demaconsulting/DotnetToolWrapper/discussions
+[dotnet-tools]: https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools
+[nuget-package-creation]: https://learn.microsoft.com/en-us/nuget/create-packages/creating-a-package
+[nuget-cli-reference]: https://learn.microsoft.com/en-us/nuget/reference/nuget-exe-cli-reference