Skip to content

Commit 1ea5a81

Browse files
committed
Configure independent package publishing after alpha
- Remove linked packages configuration from Changesets - Update documentation to reflect independent versioning strategy - Update release process documentation with numbered steps
1 parent 36e8d3b commit 1ea5a81

File tree

4 files changed

+14
-32
lines changed

4 files changed

+14
-32
lines changed

.changeset/config.json

Lines changed: 3 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,11 @@
11
{
22
"$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
3-
"changelog": "@changesets/cli/changelog",
3+
"changelog": ["@changesets/changelog-github", { "repo": "ydb-platform/ydb-js-sdk" }],
44
"commit": false,
5-
"fixed": [
6-
[
7-
"@ydbjs/abortable",
8-
"@ydbjs/api",
9-
"@ydbjs/auth",
10-
"@ydbjs/core",
11-
"@ydbjs/debug",
12-
"@ydbjs/error",
13-
"@ydbjs/query",
14-
"@ydbjs/retry",
15-
"@ydbjs/topic",
16-
"@ydbjs/value"
17-
]
18-
],
5+
"fixed": [],
196
"linked": [],
207
"access": "public",
218
"baseBranch": "main",
229
"updateInternalDependencies": "patch",
23-
"ignore": [
24-
"@ydbjs/examples-*"
25-
]
10+
"ignore": ["@ydbjs/examples-*"]
2611
}

AGENTS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,7 +480,7 @@ Select affected packages, choose bump type (major/minor/patch), write user-facin
480480
**Important Rules:**
481481

482482
- **DO NOT create CHANGELOG.md files manually** - Changesets automatically generates them from changeset files in `.changeset/` directory
483-
- **If you create or delete packages in `packages/` directory** - Update the `fixed` array in `.changeset/config.json` to include new packages or remove deleted ones (packages must be listed alphabetically)
483+
- **Do not add packages to the `fixed` array in `.changeset/config.json`** - we publish packages independently; only introduce fixed groups if we explicitly decide to lock versions again
484484
- Third-parties packages (`third-parties/`) are NOT included in `fixed` array - they version independently
485485

486486
See `RELEASING.md` and `VERSIONING.md` for full release process

RELEASING.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ This document describes how we cut stable releases for all packages in this mono
55
## Versioning Strategy
66

77
- Packages follow SemVer.
8-
- We release coordinated versions across `@ydbjs/*` where feasible.
8+
- Packages are versioned independently based on their own changesets.
99
- Pre-releases use the `alpha` tag; stable uses `latest`.
1010

1111
See VERSIONING.md for details.
@@ -20,38 +20,38 @@ See VERSIONING.md for details.
2020

2121
## Release Steps
2222

23-
1) Ensure workspace builds and tests pass
23+
1. Ensure workspace builds and tests pass
2424

2525
```bash
2626
npm run build
2727
npm test:all
2828
```
2929

30-
2) Verify package entry points and exports with ATTW
30+
2. Verify package entry points and exports with ATTW
3131

3232
```bash
3333
npm run attw
3434
```
3535

36-
3) Bump versions and generate changelogs (Changesets)
36+
3. Bump versions and generate changelogs (Changesets)
3737

3838
```bash
3939
npx changeset version
4040
```
4141

42-
4) Publish to npm (stable)
42+
4. Publish to npm (stable)
4343

4444
```bash
4545
# Ensure you are authenticated: npm whoami
4646
NPM_CONFIG_PROVENANCE=true npx changeset publish
4747
```
4848

49-
5) Create GitHub Release
49+
5. Create GitHub Release
5050

5151
- Tag matches monorepo state (e.g., v7.0.0)
5252
- Paste aggregated changelog highlights
5353

54-
6) Announce breaking changes and migration notes
54+
6. Announce breaking changes and migration notes
5555

5656
- Link MIGRATION.md sections in release notes
5757

VERSIONING.md

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,16 +6,13 @@ We use Semantic Versioning for all `@ydbjs/*` packages.
66
- MINOR: backwards-compatible features
77
- PATCH: bug fixes and docs/typings improvements
88

9-
## Coordinated Releases
9+
## Independent Releases
1010

11-
Where possible, packages share the same major/minor to reduce friction:
11+
Packages publish versions independently. Bump only the packages affected by a changeset and keep dependency ranges broad enough (typically `^major.minor.0`) for consumers to pick up compatible updates.
1212

13-
- @ydbjs/core, @ydbjs/query, @ydbjs/value, @ydbjs/api, @ydbjs/error, @ydbjs/retry, @ydbjs/auth
14-
15-
Internal APIs may evolve without public guarantees. Public APIs are documented in each package README and types.
13+
When a change requires updates in dependent packages, include changesets for each affected package so they release together, but do not force unrelated packages to bump.
1614

1715
## Pre-releases
1816

1917
- Pre-releases use the `alpha` tag and semver pre-release identifiers (e.g., 7.0.0-alpha.33)
2018
- Stable releases use the `latest` tag
21-

0 commit comments

Comments
 (0)