Skip to content

Go Live: publish latest API docs#66

Merged
mattleibow merged 4 commits into
livefrom
main
Feb 27, 2026
Merged

Go Live: publish latest API docs#66
mattleibow merged 4 commits into
livefrom
main

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

Merge main into live to publish the latest API documentation.

mattleibow and others added 4 commits February 27, 2026 11:58
Full workflow that checks out mono/SkiaSharp at a configurable branch,
installs GTK# 2 MSI, and runs Cake doc generation targets. Supports a
skiasharp-branch parameter to generate docs from any SkiaSharp branch.

Schedule: daily at 6 AM UTC, plus manual workflow_dispatch.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Manual workflow_dispatch that creates a PR from main to live.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 44e137e:

✅ Validation status: passed

File Status Preview URL Details
.github/workflows/go-live.yml ✅Succeeded
.github/workflows/update-docs.yml ✅Succeeded
SkiaSharpAPI/HarfBuzzSharp/Feature.xml ✅Succeeded
SkiaSharpAPI/HarfBuzzSharp/FontExtents.xml ✅Succeeded
SkiaSharpAPI/HarfBuzzSharp/GlyphExtents.xml ✅Succeeded
SkiaSharpAPI/HarfBuzzSharp/GlyphInfo.xml ✅Succeeded
SkiaSharpAPI/HarfBuzzSharp/GlyphPosition.xml ✅Succeeded
SkiaSharpAPI/HarfBuzzSharp/OpenTypeColorLayer.xml ✅Succeeded
SkiaSharpAPI/HarfBuzzSharp/OpenTypeMathGlyphPart.xml ✅Succeeded
SkiaSharpAPI/HarfBuzzSharp/OpenTypeMathGlyphVariant.xml ✅Succeeded
SkiaSharpAPI/HarfBuzzSharp/OpenTypeNameEntry.xml ✅Succeeded
SkiaSharpAPI/HarfBuzzSharp/OpenTypeVarAxis.xml ✅Succeeded
SkiaSharpAPI/HarfBuzzSharp/OpenTypeVarAxisInfo.xml ✅Succeeded
SkiaSharpAPI/HarfBuzzSharp/Variation.xml ✅Succeeded
SkiaSharpAPI/SkiaSharp.Internals/IPlatformLock.xml ✅Succeeded
SkiaSharpAPI/SkiaSharp.Skottie/Animation.xml ✅Succeeded
SkiaSharpAPI/SkiaSharp.Skottie/AnimationBuilderStats.xml ✅Succeeded
SkiaSharpAPI/SkiaSharp.Views.Android/GLTextureView+IEGLConfigChooser.xml ✅Succeeded
SkiaSharpAPI/SkiaSharp.Views.Android/GLTextureView+IEGLContextFactory.xml ✅Succeeded
SkiaSharpAPI/SkiaSharp.Views.Android/GLTextureView+IEGLWindowSurfaceFactory.xml ✅Succeeded
SkiaSharpAPI/SkiaSharp.Views.Android/GLTextureView+IGLWrapper.xml ✅Succeeded
SkiaSharpAPI/SkiaSharp.Views.Android/GLTextureView+IRenderer.xml ✅Succeeded
SkiaSharpAPI/SkiaSharp.Views.Android/SKGLSurfaceView+ISKRenderer.xml ✅Succeeded
SkiaSharpAPI/SkiaSharp.Views.Android/SKGLTextureView+ISKRenderer.xml ✅Succeeded
SkiaSharpAPI/SkiaSharp.Views.Mac/ISKCanvasLayerDelegate.xml ✅Succeeded

This comment lists only the first 25 files in the pull request.
For more details, please refer to the build report.

@mattleibow mattleibow merged commit cde9303 into live Feb 27, 2026
4 checks passed
mattleibow added a commit that referenced this pull request Jun 30, 2026
The previous Go Live PR (#66) was squash-merged into `live`, which broke
the shared history between `main` and `live` and caused 188 conflicting
files in PR #171.

This merge commit reconnects the two histories. It merges `live` into
`main` while keeping `main`'s tree verbatim (main is the source of truth
for the generated API docs). No file contents on `main` change; this only
restores the common ancestry so PR #171 (main -> live) becomes a clean
fast-forward and future Go Live merges stop conflicting.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
mattleibow added a commit that referenced this pull request Jun 30, 2026
Go Live: publish latest API docs (#171)

Publish the accumulated SkiaSharp / HarfBuzzSharp API documentation from main
to the live (published) branch. This is the first Go Live since #66 and rolls up
a large batch of docs automation, a full regeneration, and content/cross-reference
cleanup.

Highlights in this batch:

- Docs automation: automated API docs writer (#92, hardened in #155), daily
  update workflow, go-live workflow (#65), and a Learn Build status-based
  auto-merge gate (#82, #83) backed by check-learn-build.py and a
  .github/known-warnings.csv baseline.
- Regeneration: frameworks docs switched to latest-only monikers (#141), baseline
  reset to the Windows-generated output (#142), and stub regeneration moved to
  Linux via Mono (#147). This drops older, no-longer-shipping member/type pages
  (e.g. pre-v1.68 view APIs, the removed Android ISKRenderer interface, and the
  SKPaint text properties that moved to SKFont).
- Content: filled API documentation placeholders (#150, #151, #172) and fixed
  broken cross-references (#152).
- Cross-reference cleanup (#173): removed/repointed 36 obsolete xref-not-found
  references left behind by the latest-only-moniker regeneration — dangling links
  in 2019-era remarks to members that were since removed or relocated. Without
  this the Go Live build reported 160 warnings and the auto-merge gate (correctly)
  blocked the publish.

Build health at publish: 0 errors, 124 warnings, 0 suggestions. All 124 remaining
warnings are expected xref-not-found references to external framework types
(OpenTK, Gdk/Cairo/Graphene, ElmSharp/Tizen.NUI, Windows.UI.Xaml, Microsoft.UI.Xaml,
SharpVk, Vortice) that Learn cannot resolve and which are tracked in the
known-warnings.csv baseline — 0 new warnings versus baseline, so the gate passes.

Co-authored-by: Matthew Leibowitz <mattleibow@live.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant