cleanup of readme and documentation

Author: AlanBarber

README.md

@@ -23,6 +23,7 @@ ResultR is a lightweight request/response dispatcher for .NET applications. It r
 - No notifications or pub/sub messaging
 - No pipeline behaviors or middleware chains
 - No stream handling
+- No distributed messaging
 
 This focused scope keeps the library small, fast, and easy to understand.
 
@@ -54,6 +55,11 @@ ResultR prioritizes:
 - **Explicit over implicit**: Clear pipeline execution with predictable behavior
 - **Modern C# practices**: Leverages latest language features and patterns
 
+## 📋 Requirements
+
+- .NET 10.0 or later
+- C# 14.0 or later
+
 ## 📥 Installation
 
 ```bash
@@ -75,7 +81,7 @@ dotnet add package ResultR.Validation
 ### 1. Define a Request
 
 ```csharp
-public record CreateUserRequest(string Email, string Name) : IRequest<User>;
+public record CreateUserRequest(string Email, string Name, int Age) : IRequest<User>;
 ```
 
 ### 2. Create a Handler
@@ -115,7 +121,7 @@ public class CreateUserHandler : IRequestHandler<CreateUserRequest, User>
     public async ValueTask<Result<User>> HandleAsync(CreateUserRequest request, CancellationToken cancellationToken)
     {
         // Exceptions are automatically caught and converted to Result.Failure
-        var user = new User(request.Email, request.Name);
+        var user = new User(request.Email, request.Name, request.Age);
         await _repository.AddAsync(user, cancellationToken);
         return Result<User>.Success(user);
     }
@@ -284,6 +290,10 @@ public class ValidatingHandler : IRequestHandler<CreateOrderRequest, Order>
 
 ## ❓ FAQ
 
+### Why ResultR?
+
+ResultR prioritizes simplicity and explicitness over flexibility, giving you a focused request/handler pattern without the complexity of pipelines, behaviors, or middleware chains that you may never need. Every operation returns a unified Result or Result<T> type, making error handling consistent and predictable across your entire codebase. The optional inline hooks (ValidateAsync, BeforeHandleAsync, AfterHandleAsync) let you add cross-cutting concerns directly in your handlers without separate classes or DI registrations, keeping related logic together and reducing ceremony.
+
 ### Why "Dispatcher" instead of "Mediator"?
 
 The classic GoF Mediator pattern describes an object that coordinates bidirectional communication between multiple colleague objects - think of a chat room where participants talk *through* the mediator to each other.
@@ -323,10 +333,17 @@ cd src/ResultR.Benchmarks
 dotnet run -c Release
 ```
 
-## 📋 Requirements
+## 💬 Support
 
-- .NET 10.0 or later
-- C# 14.0 or later
+- **Issues**: [GitHub Issues](https://github.com/AlanBarber/ResultR/issues)
+- **Documentation**: [GitHub Wiki](https://github.com/AlanBarber/ResultR/wiki)
+
+## 🔗 Links
+
+- [GitHub Repository](https://github.com/AlanBarber/ResultR)
+- [ResultR on NuGet](https://www.nuget.org/packages/ResultR)
+- [ResultR.Validation on NuGet](https://www.nuget.org/packages/ResultR.Validation)
+- [ResultR.VSToolkit on VS Marketplace](https://marketplace.visualstudio.com/items?itemName=AlanBarber.ResultR-VSToolkit)
 
 ## 🤝 Contributing
 
@@ -336,10 +353,6 @@ Contributions are welcome! Please feel free to submit a Pull Request.
 
 ISC License - see the [LICENSE](https://github.com/AlanBarber/ResultR/blob/main/LICENSE) file for details.
 
-## 💬 Support
-
-- **Issues**: [GitHub Issues](https://github.com/AlanBarber/ResultR/issues)
-
 ---
 
 Built with ❤️ for the C# / DotNet community.

docs/images/icon-32px.png

@@ -78,6 +78,7 @@ else
 ### Optional Packages
 
 - [ResultR.Validation](ResultR.Validation) - Inline validation with fluent API
+- [ResultR.VSToolkit](ResultR.VSToolkit) - Visual Studio extension for navigation and scaffolding
 
 ## Requirements
 

docs/wiki/Home.md

@@ -0,0 +1,148 @@
+# ResultR VS Toolkit
+
+Supercharge your ResultR development workflow with instant navigation from requests to handlers and one-click scaffolding of new request/handler pairs. The ResultR VS Toolkit is the essential companion extension for developers using the ResultR library.
+
+## Installation
+
+### From Visual Studio Marketplace
+
+1. Open Visual Studio 2022
+2. Go to **Extensions** → **Manage Extensions**
+3. Search for "ResultR"
+4. Click **Download** and restart Visual Studio
+
+### From GitHub Releases
+
+1. Download the `.vsix` file from the [releases page](https://github.com/AlanBarber/ResultR/releases)
+2. Double-click to install
+3. Restart Visual Studio
+
+## Requirements
+
+- Visual Studio 2022 (17.0 or later)
+- Projects using the [ResultR](https://www.nuget.org/packages/ResultR) library
+
+## Features
+
+### Go to Handler Navigation
+
+Instantly navigate from any `IRequest` or `IRequest<T>` type to its corresponding handler implementation.
+
+#### How to Use
+
+![Go to Handler Context Menu](images/go-to-handler-context-menu.png)
+
+1. Place your cursor on any `IRequest` type (variable, parameter, or class definition)
+2. Use one of these methods:
+   - **Keyboard**: Press `Ctrl+R, Ctrl+H`
+   - **Context Menu**: Right-click and select **"Go to Handler..."**
+
+#### What It Finds
+
+The toolkit searches your entire solution for handlers that implement:
+- `IRequestHandler<TRequest>` for `IRequest` types
+- `IRequestHandler<TRequest, TResponse>` for `IRequest<TResponse>` types
+
+It works across projects, so your handler can be in a completely different assembly.
+
+#### Example
+
+![Go to Handler Demo](images/go-to-handler-demo.gif)
+
+```csharp
+// Place cursor on HelloWorldRequest and press Ctrl+R, Ctrl+H
+var request = new HelloWorldRequest();
+var result = await dispatcher.Dispatch(request);
+```
+
+The toolkit will navigate to:
+
+```csharp
+public class HelloWorldHandler : IRequestHandler<HelloWorldRequest>
+{
+    public async ValueTask<Result> HandleAsync(HelloWorldRequest request, CancellationToken cancellationToken)
+    {
+        // Handler implementation
+    }
+}
+```
+
+### Scaffold Request/Handler Pairs
+
+Quickly create new request and handler classes with proper namespaces and structure.
+
+#### How to Use
+
+1. In **Solution Explorer**, right-click on a project or folder
+2. Select **Add** → **ResultR Request / Handler...**
+3. Enter the request name (e.g., "HelloWorld")
+4. Click **Create**
+
+![Add Request Handler Menu](images/add-request-handler-menu.png)
+
+![Create Request Handler Dialog](images/create-request-handler-dialog.png)
+
+![Scaffold Demo](images/scaffold-demo.gif)
+
+#### What Gets Generated
+
+The toolkit creates a single `.cs` file containing both the request and handler:
+
+```csharp
+using ResultR;
+
+namespace HelloWorldApp
+{
+    public record HelloWorldRequest() : IRequest;
+
+    public class HelloWorldHandler : IRequestHandler<HelloWorldRequest>
+    {
+        public async ValueTask<Result> HandleAsync(HelloWorldRequest request, CancellationToken cancellationToken)
+        {
+            throw new NotImplementedException();
+        }
+    }
+}
+```
+
+#### Smart Namespace Detection
+
+The toolkit automatically:
+- Detects your project's namespace conventions
+- Uses file-scoped namespaces if your project uses them
+- Uses block-scoped namespaces if that's your convention
+- Places the file in the correct folder with the correct namespace
+
+## Keyboard Shortcuts
+
+| Action | Shortcut |
+|--------|----------|
+| Go to Handler | `Ctrl+R, Ctrl+H` |
+
+## Troubleshooting
+
+### "No handler found" message
+
+This can happen if:
+- The handler doesn't exist yet
+- The handler is in a project that isn't loaded
+- The handler doesn't implement the correct interface
+
+### Navigation goes to wrong handler
+
+Ensure your handler implements the exact interface for your request type. For example:
+- `GetUserRequest : IRequest<User>` should have a handler implementing `IRequestHandler<GetUserRequest, User>`
+
+### Scaffold menu item not visible
+
+The "ResultR Request / Handler..." menu item only appears when you right-click on:
+- A C# project
+- A folder within a C# project
+
+## Links
+
+- [ResultR on NuGet](https://www.nuget.org/packages/ResultR)
+- [ResultR.Validation on NuGet](https://www.nuget.org/packages/ResultR.Validation)
+- [VS Marketplace](https://marketplace.visualstudio.com/items?itemName=AlanBarber.ResultR-VSToolkit)
+- [GitHub Repository](https://github.com/AlanBarber/ResultR)
+- [Report Issues](https://github.com/AlanBarber/ResultR/issues)

docs/wiki/ResultR.VSToolkit.md

@@ -0,0 +1,55 @@
+# ResultR VS Toolkit
+
+Supercharge your [ResultR](https://github.com/AlanBarber/ResultR) development workflow with instant navigation from requests to handlers and one-click scaffolding of new request/handler pairs. The ResultR VS Toolkit is the essential companion extension for developers using the [ResultR](https://github.com/AlanBarber/ResultR) library.
+
+## Features
+
+### ⚡Navigate Your Codebase Instantly 
+
+Tired of hunting through your solution to find the handler for a request? The ResultR VS Toolkit makes navigation effortless! Simply place your cursor on any IRequest type - whether it's a variable, parameter, or class definition - and press Ctrl+R, Ctrl+H (or right-click and select "Go to Handler..."). The toolkit instantly locates and opens the corresponding IRequestHandler implementation, even if it's in a completely different project. No more manual searching, no more wasted time. Just click and you're there!
+
+### 📝 Scaffold New Request/Handler Pairs
+
+Creating new request/handler pairs has never been easier! Right-click on any project or folder in Solution Explorer and select "ResultR Request / Handler..." from the Add menu. Enter your request name, and the toolkit generates a properly structured .cs file with the correct namespace (automatically detecting whether you use file-scoped or block-scoped namespaces), all the necessary using statements, and a ready-to-implement handler class. The generated code follows your project's existing conventions, so it fits right in with your codebase. Spend less time on boilerplate and more time on what matters - your business logic! 
+
+## Requirements
+
+- Visual Studio 2022 (17.0 or later)
+- Projects using the [ResultR](https://github.com/AlanBarber/ResultR) library
+
+## Installation
+
+1. Download the `.vsix` file from the [releases page](https://github.com/AlanBarber/ResultR/releases)
+2. Double-click to install
+3. Restart Visual Studio
+
+Or search for "ResultR" in the Visual Studio Extensions marketplace.
+
+## ❓ Why ResultR VS Toolkit?
+
+The ResultR VS Toolkit provides a simple way to navigate between `IRequest`/`IRequest<T>` classes and their corresponding `IRequestHandler` implementations. It also provides a scaffold for creating new request/handler pairs. It's the perfect companion to the [ResultR](https://github.com/AlanBarber/ResultR) library!
+
+## 💬 Support
+
+- **Documentation**: [GitHub Wiki](https://github.com/AlanBarber/ResultR/wiki/ResultR.VSToolkit)
+- **Issues**: [GitHub Issues](https://github.com/AlanBarber/ResultR/issues)
+
+
+## 🔗 Links
+
+- [GitHub Repository](https://github.com/AlanBarber/ResultR)
+- [ResultR on NuGet](https://www.nuget.org/packages/ResultR)
+- [ResultR.Validation on NuGet](https://www.nuget.org/packages/ResultR.Validation)
+- [ResultR.VSToolkit on VS Marketplace](https://marketplace.visualstudio.com/items?itemName=AlanBarber.ResultR-VSToolkit)
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+ISC License - see the [LICENSE](https://github.com/AlanBarber/ResultR/blob/main/LICENSE) file for details.
+
+---
+
+Built with ❤️ for the C# / DotNet community.