Skip to content

+ the Office and Win32 packages get a generated API reference like the rest - #20

Merged
Hawkynt merged 1 commit into
mainfrom
docs/office-win32-reference
Aug 31, 2026
Merged

Hawkynt merged 1 commit into
mainfrom
docs/office-win32-reference

Conversation

@Hawkynt

@Hawkynt Hawkynt commented Aug 31, 2026

Copy link
Copy Markdown
Owner

Five of the seven documented packages moved their API table into REFERENCE.md; Microsoft.Office.Extensions and Microsoft.Win32.Extensions still carried theirs inline. The package READMEs job never touched them either — neither appears in its build loop or its project: list — so nothing regenerated or checked them, and the drift was invisible.

The generator was refusing them for a good reason, not a missing build: it needs <RepositoryUrl> or <PackageProjectUrl> before it will write the pointer, because a package readme renders on nuget.org where a relative link resolves nowhere. These two csproj files were the only ones carrying neither. They now have the same pair as their siblings, aimed at their own directory.

Both build at net6.0 — the framework the job's loop already selects for them — so they join the loop and the checked list and stay current from here.

Generated locally: Win32 1 type, Office 10 types. I deliberately did not commit regenerated references for the WPF/WinForms/Drawing packages: this machine is Linux and cannot resolve their Windows assemblies, so regenerating them here drops types (System.Drawing came back 912 instead of 1021). Those stay exactly as the Windows runner produced them.

…e rest

Both carried their API table inline while the other five had moved it to
REFERENCE.md, and the readme job never touched them: neither appeared in its
build loop or its project list, so nothing regenerated or checked them.

The generator was also refusing them on purpose. It needs <RepositoryUrl> or
<PackageProjectUrl> to write an absolute link, because a package readme renders
on nuget.org where a relative one resolves nowhere - and these two csproj files
were the only ones without either. They now carry the same pair as their
siblings, pointing at their own directory.

Both build at net6.0, the framework the job's loop picks for them, so they join
the loop and the checked list and stay current from here.
@Hawkynt
Hawkynt merged commit f79b736 into main Aug 31, 2026
8 checks passed
@Hawkynt
Hawkynt deleted the docs/office-win32-reference branch August 31, 2026 20:53
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