Skip to content

IS-11744 Document the branching model for consumers - #347

Merged
markoweb merged 2 commits into
mainfrom
fix/main/IS-11744-document-branching-model
Oct 1, 2026
Merged

markoweb merged 2 commits into
mainfrom
fix/main/IS-11744-document-branching-model

Conversation

@markoweb

@markoweb markoweb commented Oct 1, 2026

Copy link
Copy Markdown
Contributor

IS-11744 — adds a Branches and releases section to the README.

dev was merged into main and deleted on 2026-09-30 (#341, #342), so main is now the development trunk rather than a mirror of the latest release. Nothing in the repository says so yet: anyone cloning main today silently gets development work. This section tells consumers to check out the version branch for their Identity Server version instead.

  • Version branches are the recommended reference: they keep receiving fixes for their release after it ships, without picking up unreleased work from main.
  • ui-kit-<version> tags are mentioned as the way to get the exact state that shipped, and as the only option for releases that have no version branch (there is no version/11.0).

The command uses a version/<major>.<minor> placeholder with an example, so it does not go stale as new versions ship.

This replaces the README part of #301, which is now redundant — its merge already landed via #341/#342.

The matching product-docs change, pointing the clone instruction in the Identity Server documentation at the version branch, is a separate Identity Server PR under IS-11678.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

The documented placeholder command is invalid shell syntax.

Review effort: Balanced
Findings: 1 Low severity

Open (1)
What changed in this PR

Documents how consumers should select stable release branches or exact release tags instead of main.

Changes:

  • Explains the new main development-trunk model.
  • Documents version branches and release tags.
File Description
README.md Adds branch and release guidance.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread README.md Outdated
Comment thread README.md Outdated
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@markoweb
markoweb merged commit 710637e into main Oct 1, 2026
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.

4 participants