Skip to content

docs: per-package NuGet READMEs and packaging wiring - #156

Merged
Tim81 merged 1 commit into
mainfrom
packaging-per-package-nuget-readmes
Jul 6, 2026
Merged

docs: per-package NuGet READMEs and packaging wiring#156
Tim81 merged 1 commit into
mainfrom
packaging-per-package-nuget-readmes

Conversation

@Tim81

@Tim81 Tim81 commented Jul 6, 2026

Copy link
Copy Markdown
Owner

Give each shippable package its own NuGet README instead of the shared repository README, so each package's nuget.org listing shows package-specific content.

Changes

  • Move the README pack rule out of Directory.Build.props into Directory.Build.targets, where it updates the SDK's default None item and falls back to the root README for packages without their own.
  • Add per-package READMEs for Kernel, Fonts.Standard14, Layout, Signing, Reader, Conformance, Cli, and Barcodes, sharing the package-family and roadmap tables.
  • Add docs/barcodes-roadmap.md recording the post-1.9.0 barcode verification pass.
  • Add the Barcodes roadmap row to the root README and document the Code 128 FNC4, GS1-128 HRI, and ITF-14 bearer-bar limitations in the barcode guide.

Verification

  • Clean-room check: pass
  • dotnet build VellumPdf.slnx -c Release: 0 warnings, 0 errors
  • dotnet format VellumPdf.slnx --verify-no-changes: clean
  • dotnet pack VellumPdf.slnx -c Release: confirmed each .nupkg bundles its own README (Barcodes and Kernel READMEs differ in size)

No code changes — documentation and packaging only.

Each shippable package now ships its own README so its NuGet listing shows
package-specific content instead of the repository README. Move the README
pack rule out of Directory.Build.props into Directory.Build.targets, where it
updates the SDK's default None item and falls back to the root README for
packages without one.

- Add per-package READMEs for Kernel, Fonts.Standard14, Layout, Signing,
  Reader, Conformance, Cli, and Barcodes, sharing the package-family and
  roadmap tables.
- Add docs/barcodes-roadmap.md recording the post-1.9.0 verification pass.
- Add the Barcodes roadmap row to the root README and document the Code 128
  FNC4, GS1-128 HRI, and ITF-14 bearer-bar limitations in the barcode guide.
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