Add comprehensive developer guide

[Copilot]

Adds /docs/guide/guide.md as a detailed reference for developers integrating the TestResults library.

Content Structure

• Introduction: Library purpose, use cases, and supported formats (TRX/JUnit)
• Prerequisites: .NET 8/9/10 requirements and tooling
• Adding to Project: Installation via dotnet CLI, Visual Studio Package Manager, and manual reference
• Creating Test Results: 15+ complete examples covering:
  • Basic and advanced test result creation
  • Both TRX and JUnit serialization
  • All 14 test outcomes (Passed, Failed, Error, Timeout, etc.)
  • Output capture (SystemOutput, SystemError)
  • Test metadata (duration, timestamps, computer name)
  • Bidirectional format conversion
• Advanced Usage: Extension methods, result aggregation, filtering, summary reporting
• FAQ: 12 common questions including format support, conversion, thread safety, framework integration

Example Usage

using DemaConsulting.TestResults;
using DemaConsulting.TestResults.IO;

var results = new TestResults { Name = "MyTests" };

results.Results.Add(new TestResult
{
    Name = "Test1",
    ClassName = "MyTests",
    CodeBase = "MyAssembly",
    Outcome = TestOutcome.Passed,
    Duration = TimeSpan.FromSeconds(1.5)
});

File.WriteAllText("results.trx", TrxSerializer.Serialize(results));
File.WriteAllText("results.xml", JUnitSerializer.Serialize(results));

All code examples include necessary using statements and are fully runnable.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[Feature]: Detailed Developer Guide</issue_title>
<issue_description>### Problem Statement

I would like a detailed developer guide document.

Proposed Solution

Create a developer guide document under /docs/guide/guide.md with detailed sections for:

• Introduction
• Prerequisites
• Adding to Project
• Creating Test Results (with example)
• FAQ

Alternatives Considered

No response

Usage Examples

Benefits

This document would assist developers in using the TestResults tool.

Priority

Medium - Would improve my workflow

Willingness to Contribute

Yes, I can submit a pull request

Additional Context

No response

Checklist

• I have searched existing issues to ensure this is not a duplicate
• I have provided a clear description of the feature
• I have explained why this feature would be useful</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes [Feature]: Detailed Developer Guide #55

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.