Restructure package layout and convert to markdown reference links

- Move native executables to package root to avoid duplication
- Update DotnetToolWrapper.json paths to use ../../../ relative paths
- Convert all markdown files to use reference link format
- Update folder structure examples in docs/usage.md and README.md

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](https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools).
+applications packaged as [.NET Tools][link1].
 
 ## Project Structure
 
@@ -130,3 +130,5 @@ Before committing:
 ## Contact
 
 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

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](https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools). It enables developers to distribute
+as [.NET Tools][link1]. It enables developers to distribute
 platform-specific native executables through the .NET tool ecosystem.
 
 ## Problem Statement
@@ -171,3 +171,5 @@ The project uses GitHub Actions for CI/CD:
 - [README.md](README.md) - Usage instructions and examples
 - [CONTRIBUTING.md](CONTRIBUTING.md) - Contribution guidelines
 - [SECURITY.md](SECURITY.md) - Security policy
+
+[link1]: 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](https://dotnet.microsoft.com/download)
+- [.NET SDK 8.0 or higher][link1]
 - Git
 - A code editor (Visual Studio, Visual Studio Code, Rider, etc.)
 
@@ -232,9 +232,15 @@ See [LICENSE](LICENSE) for details.
 
 ## Additional Resources
 
-- [.NET Tool Documentation](https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools)
-- [NuGet Package Documentation](https://learn.microsoft.com/en-us/nuget/)
-- [GitHub Flow](https://guides.github.com/introduction/flow/)
-- [Writing Good Commit Messages](https://chris.beams.io/posts/git-commit/)
+- [.NET Tool Documentation][link2]
+- [NuGet Package Documentation][link3]
+- [GitHub Flow][link4]
+- [Writing Good Commit Messages][link5]
 
 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/

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](https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools).
+[.NET Tools][link1].
 
 ## Overview
 
@@ -34,7 +34,7 @@ dotnet tool install -g YourTool.Package
 your-tool --help
 ```
 
-Create your own wrapped tool by following the [Usage](#usage) section below.
+Create your own wrapped tool by following the [Usage][link2] section below.
 
 ## Usage
 
@@ -54,6 +54,9 @@ Here's a minimal folder structure:
 ```text
 root
 |- tool.nuspec
+|- win-x64/my-tool.exe
+|- linux-x64/my-tool
+|- osx-arm64/my-tool
 |- tools
    |- net8.0/any
    |- net9.0/any
@@ -62,9 +65,6 @@ root
       |- DotnetToolWrapper.json
       |- DemaConsulting.DotnetToolWrapper.dll
       |- (other wrapper files)
-      |- win-x64/my-tool.exe
-      |- linux-x64/my-tool
-      |- osx-arm64/my-tool
 ```
 
 Package and install:
@@ -135,7 +135,7 @@ dotnet build --configuration Release
 
 For real-world examples of tools using DotnetToolWrapper, see:
 
-- Check the [GitHub topic](https://github.com/topics/dotnettoolwrapper) for projects using this wrapper
+- Check the [GitHub topic][link3] for projects using this wrapper
 
 ## Contributing
 
@@ -153,6 +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](https://github.com/demaconsulting/DotnetToolWrapper/issues)
-- **Discussions**: Ask questions via [GitHub Discussions](https://github.com/demaconsulting/DotnetToolWrapper/discussions)
+- **Issues**: Report bugs or request features via [GitHub Issues][link4]
+- **Discussions**: Ask questions via [GitHub Discussions][link5]
 - **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

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](https://github.com/demaconsulting/DotnetToolWrapper/security) of the repository
+1. Navigate to the [Security tab][link1] 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](https://www.microsoft.com/en-us/securityengineering/sdl/)
-- [OWASP Secure Coding Practices](https://owasp.org/www-project-secure-coding-practices-quick-reference-guide/)
-- [GitHub Security Advisories](https://docs.github.com/en/code-security/security-advisories)
+- [Microsoft Security Development Lifecycle][link2]
+- [OWASP Secure Coding Practices][link3]
+- [GitHub Security Advisories][link4]
 
 ## Updates to This Policy
 
@@ -188,3 +188,8 @@ We may update this security policy from time to time. We will notify users of ma
 - Creating a GitHub discussion for significant changes
 
 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

docs/usage.md

@@ -33,6 +33,12 @@ target .NET frameworks (net8.0, net9.0, and net10.0) to ensure compatibility:
 root
 |- tool.nuspec                                                   Nuspec file
 |- README.md                                                     README file
+|- win-x64
+|  |- my-tool.exe                                               Windows x64 executable
+|- linux-x64
+|  |- my-tool                                                   Linux x64 executable
+|- osx-x64
+|  |- my-tool                                                   macOS x64 executable
 |- tools
    |- net8.0
    |  |- any
@@ -41,38 +47,20 @@ root
    |     |- DemaConsulting.DotnetToolWrapper.deps.json           DotnetToolWrapper dependencies
    |     |- DemaConsulting.DotnetToolWrapper.dll                 DotnetToolWrapper application
    |     |- DemaConsulting.DotnetToolWrapper.runtimeconfig.json  DotnetToolWrapper runtime
-   |     |- win-x64
-   |     |  |- my-tool.exe                                       Windows x64 executable
-   |     |- linux-x64
-   |     |  |- my-tool                                           Linux x64 executable
-   |     |- osx-x64
-   |        |- my-tool                                           macOS x64 executable
    |- net9.0
    |  |- any
    |     |- DotnetToolSettings.xml                               Dotnet tool settings
    |     |- DotnetToolWrapper.json                               DotnetToolWrapper application settings
    |     |- DemaConsulting.DotnetToolWrapper.deps.json           DotnetToolWrapper dependencies
    |     |- DemaConsulting.DotnetToolWrapper.dll                 DotnetToolWrapper application
    |     |- DemaConsulting.DotnetToolWrapper.runtimeconfig.json  DotnetToolWrapper runtime
-   |     |- win-x64
-   |     |  |- my-tool.exe                                       Windows x64 executable
-   |     |- linux-x64
-   |     |  |- my-tool                                           Linux x64 executable
-   |     |- osx-x64
-   |        |- my-tool                                           macOS x64 executable
    |- net10.0
       |- any
          |- DotnetToolSettings.xml                               Dotnet tool settings
          |- DotnetToolWrapper.json                               DotnetToolWrapper application settings
          |- DemaConsulting.DotnetToolWrapper.deps.json           DotnetToolWrapper dependencies
          |- DemaConsulting.DotnetToolWrapper.dll                 DotnetToolWrapper application
          |- DemaConsulting.DotnetToolWrapper.runtimeconfig.json  DotnetToolWrapper runtime
-         |- win-x64
-         |  |- my-tool.exe                                       Windows x64 executable
-         |- linux-x64
-         |  |- my-tool                                           Linux x64 executable
-         |- osx-x64
-            |- my-tool                                           macOS x64 executable
 ```
 
 **Note**: While the example above shows net8.0, net9.0, and net10.0 folders, you can choose to include only
@@ -117,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](https://learn.microsoft.com/en-us/nuget/reference/nuspec) for more details.
+Refer to the [.nuspec File Reference][link1] for more details.
 
 ### 2. Create DotnetToolSettings.xml
 
@@ -145,22 +133,22 @@ Create a `DotnetToolWrapper.json` file in each framework folder that maps platfo
 ```json
 {
   "win-x64": {
-    "program": "win-x64/my-tool.exe"
+    "program": "../../../win-x64/my-tool.exe"
   },
   "win-x86": {
-    "program": "win-x86/my-tool.exe"
+    "program": "../../../win-x86/my-tool.exe"
   },
   "linux-x64": {
-    "program": "linux-x64/my-tool"
+    "program": "../../../linux-x64/my-tool"
   },
   "linux-arm64": {
-    "program": "linux-arm64/my-tool"
+    "program": "../../../linux-arm64/my-tool"
   },
   "osx-x64": {
-    "program": "osx-x64/my-tool"
+    "program": "../../../osx-x64/my-tool"
   },
   "osx-arm64": {
-    "program": "osx-arm64/my-tool"
+    "program": "../../../osx-arm64/my-tool"
   }
 }
 ```
@@ -203,15 +191,15 @@ into your `tools/{framework}/any/` folder:
 
 You can obtain these files by:
 
-1. Downloading from the [releases page](https://github.com/demaconsulting/DotnetToolWrapper/releases)
-2. Building from source (see [Building from Source](#building-from-source))
+1. Downloading from the [releases page][link2]
+2. Building from source (see [Building from Source][link3])
 
 ### 5. Add Your Native Executables
 
-Place your native executables in subdirectories matching the platform identifiers. For example:
+Place your native executables at the root of the package in subdirectories matching the platform identifiers. For example:
 
 ```text
-tools/net8.0/any/
+root/
 ├── win-x64/
 │   └── my-tool.exe
 ├── linux-x64/
@@ -298,7 +286,7 @@ If you want to support multiple .NET framework versions:
 
 1. Create separate folders for each framework: `net8.0`, `net9.0`, `net10.0`
 2. Copy the appropriate DotnetToolWrapper binaries for each framework
-3. Copy your native executables to each framework folder (they can be the same binaries)
+3. Place your native executables at the root of the package (they are shared across all frameworks)
 4. Update your .nuspec to include all framework folders
 
 Users with different .NET SDK versions will automatically use the appropriate framework version.
@@ -404,20 +392,30 @@ dotnet build --configuration Release
 
 For real-world examples of tools using DotnetToolWrapper:
 
-- Browse repositories on GitHub with the [dotnettoolwrapper topic](https://github.com/topics/dotnettoolwrapper)
+- Browse repositories on GitHub with the [dotnettoolwrapper topic][link4]
 - Check the examples in the DotnetToolWrapper repository (if available)
 
 ## Support
 
-- **Issues**: Report bugs or request features via [GitHub Issues](https://github.com/demaconsulting/DotnetToolWrapper/issues)
-- **Discussions**: Ask questions via [GitHub Discussions](https://github.com/demaconsulting/DotnetToolWrapper/discussions)
+- **Issues**: Report bugs or request features via [GitHub Issues][link5]
+- **Discussions**: Ask questions via [GitHub Discussions][link6]
 - **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](https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools)
-- [.nuspec File Reference](https://learn.microsoft.com/en-us/nuget/reference/nuspec)
-- [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)
+- [.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