From 04d48fb178205f50df2ecee12b7e005fe4497147 Mon Sep 17 00:00:00 2001
From: Tom Longhurst <30480171+thomhurst@users.noreply.github.com>
Date: Tue, 30 Dec 2025 12:40:08 +0000
Subject: [PATCH 1/2] docs: Add ICommand interface documentation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add class-level XML documentation for ICommand interface with summary
describing it as the core abstraction for executing command line tools
and processes, along with remarks pointing to IBash and IPowershell
for shell-specific execution.

Closes #1650

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 src/ModularPipelines/Context/ICommand.cs | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/src/ModularPipelines/Context/ICommand.cs b/src/ModularPipelines/Context/ICommand.cs
index 734bafd648..6b05668e7e 100644
--- a/src/ModularPipelines/Context/ICommand.cs
+++ b/src/ModularPipelines/Context/ICommand.cs
@@ -3,6 +3,13 @@
 
 namespace ModularPipelines.Context;
 
+/// <summary>
+/// Provides functionality for executing command line tools and processes.
+/// </summary>
+/// <remarks>
+/// This interface is the core abstraction for running external processes.
+/// For shell-specific execution, see <see cref="IBash"/> and <see cref="IPowershell"/>.
+/// </remarks>
 public interface ICommand
 {
     /// <summary>
@@ -12,4 +19,4 @@ public interface ICommand
     /// <param name="cancellationToken">Cancellation token.</param>
     /// <returns>A <see cref="Task"/> representing the asynchronous operation.</returns>
     Task<CommandResult> ExecuteCommandLineTool(CommandLineToolOptions options, CancellationToken cancellationToken = default);
-}
\ No newline at end of file
+}

From ed05135e6eba2f4db5e1521eb23e98f4ef9bf35d Mon Sep 17 00:00:00 2001
From: Tom Longhurst <30480171+thomhurst@users.noreply.github.com>
Date: Tue, 30 Dec 2025 12:40:16 +0000
Subject: [PATCH 2/2] docs: Add AzureExtensions class documentation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add class-level XML documentation for AzureExtensions class with summary
describing extension methods for Azure integration and remarks about
using context.Azure() to access Azure CLI commands.

Also add method-level documentation for the public RegisterAzureContext
extension method describing its purpose of registering Azure services
with the dependency injection container.

Closes #1621

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 .../Extensions/AzureExtensions.cs                     | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/src/ModularPipelines.Azure/Extensions/AzureExtensions.cs b/src/ModularPipelines.Azure/Extensions/AzureExtensions.cs
index 481fd6be48..0bdc8202cf 100644
--- a/src/ModularPipelines.Azure/Extensions/AzureExtensions.cs
+++ b/src/ModularPipelines.Azure/Extensions/AzureExtensions.cs
@@ -18,6 +18,12 @@
 
 namespace ModularPipelines.Azure.Extensions;
 
+/// <summary>
+/// Extension methods for Azure integration with ModularPipelines.
+/// </summary>
+/// <remarks>
+/// Use <c>context.Azure()</c> to access Azure CLI commands from pipeline modules.
+/// </remarks>
 public static class AzureExtensions
 {
 #pragma warning disable CA2255
@@ -28,6 +34,11 @@ public static void RegisterAzureContext()
         ModularPipelinesContextRegistry.RegisterContext(collection => RegisterAzureContext(collection));
     }
 
+    /// <summary>
+    /// Registers Azure services with the dependency injection container.
+    /// </summary>
+    /// <param name="services">The service collection to register services with.</param>
+    /// <returns>The service collection for method chaining.</returns>
     public static IServiceCollection RegisterAzureContext(this IServiceCollection services)
     {
         services.TryAddScoped<IAzure, Azure>();