Simplify docs validation workflow

- Remove separate extract job and artifact upload/download
- Each language job now extracts and validates independently
- Jobs run in parallel without dependencies
- Remove docs/.gitignore (no longer needed)

Author: patniko

.github/workflows/docs-validation.yml

@@ -17,36 +17,8 @@ permissions:
   contents: read
 
 jobs:
-  extract:
-    name: "Extract Code Blocks"
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: "npm"
-          cache-dependency-path: "scripts/docs-validation/package-lock.json"
-
-      - name: Install extraction dependencies
-        working-directory: scripts/docs-validation
-        run: npm ci
-
-      - name: Extract code blocks
-        working-directory: scripts/docs-validation
-        run: npm run extract
-
-      - name: Upload extracted code
-        uses: actions/upload-artifact@v4
-        with:
-          name: extracted-code
-          path: docs/.validation/
-          retention-days: 1
-
   validate-typescript:
     name: "Validate TypeScript"
-    needs: extract
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -65,23 +37,20 @@ jobs:
         working-directory: scripts/docs-validation
         run: npm ci
 
-      - name: Download extracted code
-        uses: actions/download-artifact@v4
-        with:
-          name: extracted-code
-          path: docs/.validation/
-
-      - name: Validate TypeScript
+      - name: Extract and validate TypeScript
         working-directory: scripts/docs-validation
-        run: npm run validate:ts
+        run: npm run extract && npm run validate:ts
 
   validate-python:
     name: "Validate Python"
-    needs: extract
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
 
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
       - uses: actions/setup-python@v5
         with:
           python-version: "3.12"
@@ -100,79 +69,55 @@ jobs:
         working-directory: scripts/docs-validation
         run: npm ci
 
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-
-      - name: Download extracted code
-        uses: actions/download-artifact@v4
-        with:
-          name: extracted-code
-          path: docs/.validation/
-
-      - name: Validate Python
+      - name: Extract and validate Python
         working-directory: scripts/docs-validation
-        run: npm run validate:py
+        run: npm run extract && npm run validate:py
 
   validate-go:
     name: "Validate Go"
-    needs: extract
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
 
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
       - uses: actions/setup-go@v5
         with:
           go-version: "1.23"
           cache-dependency-path: "go/go.sum"
 
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-
       - name: Install validation dependencies
         working-directory: scripts/docs-validation
         run: npm ci
 
-      - name: Download extracted code
-        uses: actions/download-artifact@v4
-        with:
-          name: extracted-code
-          path: docs/.validation/
-
-      - name: Validate Go
+      - name: Extract and validate Go
         working-directory: scripts/docs-validation
-        run: npm run validate:go
+        run: npm run extract && npm run validate:go
 
   validate-csharp:
     name: "Validate C#"
-    needs: extract
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
 
-      - uses: actions/setup-dotnet@v4
-        with:
-          dotnet-version: "8.0.x"
-
       - uses: actions/setup-node@v4
         with:
           node-version: 22
 
+      - uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: "8.0.x"
+
       - name: Install validation dependencies
         working-directory: scripts/docs-validation
         run: npm ci
 
-      - name: Download extracted code
-        uses: actions/download-artifact@v4
-        with:
-          name: extracted-code
-          path: docs/.validation/
-
       - name: Restore SDK dependencies
         working-directory: dotnet
         run: dotnet restore
 
-      - name: Validate C#
+      - name: Extract and validate C#
         working-directory: scripts/docs-validation
-        run: npm run validate:cs
+        run: npm run extract && npm run validate:cs

docs/.gitignore

@@ -0,0 +1,12 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <OutputType>Library</OutputType>
+    <TargetFramework>net8.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <NoWarn>CS8019;CS0168;CS0219</NoWarn>
+  </PropertyGroup>
+  <ItemGroup>
+    <ProjectReference Include="/Users/patrick/projects/copilot-sdk/dotnet/src/GitHub.Copilot.SDK.csproj" />
+  </ItemGroup>
+</Project>

docs/.validation/csharp/DocsValidation.csproj

@@ -0,0 +1,21 @@
+// Source: auth/byok.md:143
+using GitHub.Copilot.SDK;
+
+await using var client = new CopilotClient();
+await using var session = await client.CreateSessionAsync(new SessionConfig
+{
+    Model = "gpt-5.2-codex",  // Your deployment name
+    Provider = new ProviderConfig
+    {
+        Type = "openai",
+        BaseUrl = "https://your-resource.openai.azure.com/openai/v1/",
+        WireApi = "responses",  // Use "completions" for older models
+        ApiKey = Environment.GetEnvironmentVariable("FOUNDRY_API_KEY"),
+    },
+});
+
+var response = await session.SendAndWaitAsync(new MessageOptions
+{
+    Prompt = "What is 2+2?",
+});
+Console.WriteLine(response?.Data.Content);

docs/.validation/csharp/byok_29.cs

@@ -0,0 +1,9 @@
+// Source: mcp/debugging.md:269
+// Windows needs cmd /c for npx
+["filesystem"] = new McpLocalServerConfig
+{
+    Type = "local",
+    Command = "cmd",
+    Args = new List<string> { "/c", "npx", "-y", "@modelcontextprotocol/server-filesystem", "C:\\allowed\\path" },
+    Tools = new List<string> { "*" },
+}

docs/.validation/csharp/debugging_10.cs

@@ -0,0 +1,16 @@
+// Source: debugging.md:61
+using GitHub.Copilot.SDK;
+using Microsoft.Extensions.Logging;
+
+// Using ILogger
+var loggerFactory = LoggerFactory.Create(builder =>
+{
+    builder.SetMinimumLevel(LogLevel.Debug);
+    builder.AddConsole();
+});
+
+var client = new CopilotClient(new CopilotClientOptions
+{
+    LogLevel = "debug",
+    Logger = loggerFactory.CreateLogger<CopilotClient>()
+});

docs/.validation/csharp/debugging_6.cs

@@ -0,0 +1,5 @@
+// Source: debugging.md:124
+var client = new CopilotClient(new CopilotClientOptions
+{
+    CliArgs = new[] { "--log-dir", "/path/to/logs" }
+});

docs/.validation/csharp/debugging_7.cs

@@ -0,0 +1,20 @@
+// Source: mcp/debugging.md:245
+// Correct configuration for .NET exe
+["my-dotnet-server"] = new McpLocalServerConfig
+{
+    Type = "local",
+    Command = @"C:\Tools\MyServer\MyServer.exe",  // Full path with .exe
+    Args = new List<string>(),
+    Cwd = @"C:\Tools\MyServer",  // Set working directory
+    Tools = new List<string> { "*" },
+}
+
+// For dotnet tool (DLL)
+["my-dotnet-tool"] = new McpLocalServerConfig
+{
+    Type = "local", 
+    Command = "dotnet",
+    Args = new List<string> { @"C:\Tools\MyTool\MyTool.dll" },
+    Cwd = @"C:\Tools\MyTool",
+    Tools = new List<string> { "*" },
+}

docs/.validation/csharp/debugging_9.cs

@@ -0,0 +1,4 @@
+// Source: hooks/error-handling.md:52
+public delegate Task<ErrorOccurredHookOutput?> ErrorOccurredHandler(
+    ErrorOccurredHookInput input,
+    HookInvocation invocation);

docs/.validation/csharp/error-handling_20.cs

@@ -0,0 +1,14 @@
+// Source: hooks/error-handling.md:142
+var session = await client.CreateSessionAsync(new SessionConfig
+{
+    Hooks = new SessionHooks
+    {
+        OnErrorOccurred = (input, invocation) =>
+        {
+            Console.Error.WriteLine($"[{invocation.SessionId}] Error: {input.Error}");
+            Console.Error.WriteLine($"  Context: {input.ErrorContext}");
+            Console.Error.WriteLine($"  Recoverable: {input.Recoverable}");
+            return Task.FromResult<ErrorOccurredHookOutput?>(null);
+        },
+    },
+});