Fill and review API documentation

[github-actions]

Summary

Filled all To be added. documentation placeholders for the newly-shipped Graphite GPU backend APIs (and related additions to SKImage, SKSurface, GRContext, and GRVkExtensions), then ran the factual / example / quality reviewers over the new content. After this change the docs-format-docs gate reports 0/453 missing types and 0/5197 missing members, 0 findings, 0 errors.

Changed files

• 332 structural, regenerated-only type XML files (assembly-version bump 4.150.0.0 → 4.151.0.0 and related stub regeneration; no <Docs> edits).
• 27 files with hand-authored <Docs> content:
  • Enums: SKGraphiteBackend, SKGraphiteInsertStatus, SKImageRescaleGamma, SKImageRescaleMode
  • Delegates: SKGraphiteReleaseDelegate, SKGraphiteVkGetProcedureAddressDelegate, SKGraphiteFindOrCreateImageDelegate
  • Structs: SKGraphiteContextOptions, SKGraphiteSubmitInfo, SKGraphiteInsertRecordingInfo, SKGraphiteVkTextureInfo, SKGraphiteDawnBackendContextInit, SKGraphiteMtlBackendContextInit
  • Classes: SKGraphiteContext, SKGraphiteRecorder, SKGraphiteRecording, SKGraphiteBackendTexture, SKGraphiteTextureInfo, SKGraphiteImageCache, SKGraphiteVkBackendContext, SKGraphiteDawnBackendContext, SKGraphiteMtlBackendContext, SKImageReadPixelsResult
  • Member additions: SKImage, SKSurface, GRContext, GRVkExtensions

What was filled and reviewed

• Add pass: 148 member placeholders + 27 type-level summaries filled from the C# source, covering the full Graphite context/recorder/recording lifecycle, backend-context and texture-info types, async read-pixels, and the new FromTexture / ToTextureImage / Create / RequestReadPixels overloads.
• Review pass (A/B/C): verified each summary/param/returns against the binding source (values, null-return semantics, exception conditions such as ArgumentOutOfRangeException on negative budgets and InvalidOperationException on synchronous submit in non-yielding environments). Added one correct, non-obsolete csharp example to the central SKGraphiteContext type showing the create → record → snap → insert → submit flow with proper using disposal and modern text-free drawing APIs.

Findings summary

• CRITICAL: 0
• HIGH: 0
• MEDIUM: 0
• LOW: 0

No factual, example, or quality defects were found in existing docs while filling; the new content was authored directly from source. Nothing deferred.

FINDING | severity=none | file=- | member=- | category=- | note=No correctness defects found; 148 member + 27 type placeholders filled and reviewed against binding source; gate clean (0 missing, 0 findings, 0 errors).

Generated by Auto API Docs Writer · opus48 · 575.4 AIC · ⌖ 19.9 AIC · ⊞ 8.7K · ◷

---

Note

This was originally intended as a pull request, but the git push operation failed.

Original error: pushSignedCommits: refusing unsigned push for branch 'automation/test-api-docs-limit-20260804-1030': E003: Signed-commit payload exceeds max-patch-size (2048 KB). Synthesized payload additions total 5508 KB

Workflow Run: View run details and download bundle artifact

The bundle file is available in the agent artifact in the workflow run linked above.

To create a pull request with the changes:

# Download the artifact from the workflow run
gh run download 30891721677 -n agent -D /tmp/agent-30891721677

# Fetch the bundle into a temporary ref, then update the local branch
git fetch /tmp/agent-30891721677/aw-automation-test-api-docs-limit-20260804-1030.bundle refs/heads/automation/test-api-docs-limit-20260804-1030:refs/bundles/create-pr-automation-test-api-docs-limit-20260804-1030-bca2e2ab
git update-ref refs/heads/automation/test-api-docs-limit-20260804-1030 refs/bundles/create-pr-automation-test-api-docs-limit-20260804-1030-bca2e2ab
git checkout automation/test-api-docs-limit-20260804-1030
# Ensure the working tree matches the updated branch
git reset --hard
# Remove the temporary bundle ref
git update-ref -d refs/bundles/create-pr-automation-test-api-docs-limit-20260804-1030-bca2e2ab

# Push the branch to origin
git push origin automation/test-api-docs-limit-20260804-1030

# Create the pull request
gh pr create --title 'Fill and review API documentation' --base main --head automation/test-api-docs-limit-20260804-1030 --repo mono/SkiaSharp-API-docs

[mattleibow]

Closed as a superseded validation artifact. PR #186 was updated to retain signed commits with a bounded 6,144 KB payload limit, and run 30895388672 successfully created generated docs PR #190 with all 359 files.