Skip to content

Prepare 0.17.0.1 release#5

Merged
adsharma merged 3 commits into
mainfrom
docs/stable-versioning-maintainer-guide
Jun 1, 2026
Merged

Prepare 0.17.0.1 release#5
adsharma merged 3 commits into
mainfrom
docs/stable-versioning-maintainer-guide

Conversation

@sergey-v9

Copy link
Copy Markdown
Collaborator

Stabilize package versioning and maintainer docs

Summary

  • Moves the package family default from 0.17.0-alpha.1 to stable 0.17.0.1.
  • Updates Cake and the release workflow so the native engine release is derived from the first three package-version segments (0.17.0.1 -> v0.17.0).
  • Replaces the development-era .agents/notes/ files with MAINTAINING.md.
  • Refreshes README.md, AGENTS.md, and example package-version defaults to match the stable fourth-segment versioning policy.

Test plan

  • dotnet build LadybugDB.slnx -c Release
  • dotnet run --project cake/LadybugDB.Build.csproj -- --target Pack --engine-version v0.17.0
  • Stale-string search for old alpha/living-notes references

Notes

  • This branch was created from the examples branch. If the examples PR has not merged yet, open this PR with base examples/database-usage-samples; otherwise retarget it to main.
  • All seven packages should be released with the same 0.17.0.1 version.

sergey-v9 added 2 commits May 31, 2026 18:24
Add runnable C# examples for quickstart queries, CSV graph loading, prepared statements, and result materialization so consumers can exercise the published package API.
Move the package family to the stable 0.17.0.1 revision scheme, derive engine releases from the first three package segments, and replace the development note files with a maintained repository guide.
@adsharma

Copy link
Copy Markdown
Contributor

LGTM except for a question about the versioning scheme.

Nuget packages seem to follow semver, which suggests 0.17.0-1 instead of 0.17.0.1. Is this something you considered?

Base automatically changed from examples/database-usage-samples to main May 31, 2026 18:33
@sergey-v9

sergey-v9 commented May 31, 2026

Copy link
Copy Markdown
Collaborator Author

LGTM except for a question about the versioning scheme.

Nuget packages seem to follow semver, which suggests 0.17.0-1 instead of 0.17.0.1. Is this something you considered?

I considered 0.17.0-1, but a hyphen suffix is a prerelease in both SemVer and NuGet. Also considered build metadata (0.17.0+dotnet.1), but NuGet ignores build metadata for package identity. Since the first three numeric segments intentionally mirror the engine's SemVer, I use NuGet's documented fourth Revision segment to represent the binding/package revision.

@adsharma adsharma merged commit 4cdf8ee into main Jun 1, 2026
3 checks passed
@adsharma adsharma deleted the docs/stable-versioning-maintainer-guide branch June 1, 2026 00:00
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.

2 participants