Repository navigation
POM descriptions for every published module; the release rehearsal in docs/14 - #157
Merged
Merged
Conversation
… docs/14 Each of the 50 published modules now sets `description` next to its `name`, so the POM's <description> (what Central's and Maven's search pages show) says what the module is instead of repeating its name. docs/14 §14.5 records what the practice release run on 2026-11-09 settled: a clean clone tagged v0.2.0 locally staged 62 modules (jar, sources, javadoc, POM, all signed, 56 MB), all 33 external dependencies resolve on Central, and sonaUpload reached VALIDATED (deployment 86b6f4e7, then dropped; nothing published). Also: which account owns net.leibman, where sbt 2 reads credentials, why the release must come from one machine (the Mac), and rehearse-then-Drop. Measured: `show coreJVM/description` etc. print the new descriptions; `sbt --error checkLinux` on this branch (stacked on the thicket_apple.h fix): exit 0, 356 tests passed, 0 failed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Note
Copilot was unable to complete this review at the selected tier due to model policy or plan restrictions.
🟡 Changes recommended
A misleading and ambiguous bullet in docs/14-releasing.md about which Apple modules are skipped (and why) remains, with a specific nit noted to clarify the gating by macOS/Xcode and the Linux vs macOS release context.
1 open issue
What changed in this PR
This pull request improves published artifact metadata by adding meaningful per-module description values in build.sbt (so generated POM <description> text is useful on Maven Central), and updates the release guide with learnings from the 2026-11-09 practice release rehearsal.
Changes:
- Add
description := ...alongsidename := ...for each published module inbuild.sbtto improve Maven Central/POM metadata. - Extend
docs/14-releasing.md(§14.5) to document what the practice release validated/settled (accounts, credentials, single-machine release guidance, andsonaUploadthen Drop).
| File | Summary | Review Notes |
|---|---|---|
docs/14-releasing.md |
Adds a practice-release section capturing outcomes and clarifying release procedure guidance. | Nits: clarify ambiguous “Off a Mac” wording; tighten/clarify the description of which Apple modules are gated by macOS/Xcode vs Linux to avoid misleading implications. |
build.sbt |
Adds per-module description settings so published POMs have informative descriptions on Maven Central. |
Nits: adjust article usage for “sttp” (“a sttp…”, not “an sttp…”) in the affected module descriptions. |
This pull request is ready to be approved.
Review effort: Balanced
Clarified release process for Mac and non-Mac hosts, detailing module staging and potential upload collisions. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
rleibman
added a commit
that referenced
this pull request
Nov 9, 2026
* Regenerate thicket_apple.h: a merge left it broken, and main's CI red Merging #152 and #151 left the kind-table comment in the generated Apple header closed early (`*/` after the Stepper row) with a duplicate `25 Tab` row outside it, as bare text before `sui_create`. That is not C, and shimGen's consistency suite has failed on main since 9f2a3bd: 45 passed, 6 failed (Linux and Apple CI both red on the #151 push). `shimGen/run` regenerates it; this is its output, and the only file it changes. Also the two-line comment in AppleRenderer that the same merge left mis-indented, which `scalafmtAll` reflows. Measured: `sbt --error checkLinux` exit 0, 356 tests passed, 0 failed (on main, shimGen alone: 6 failed). Not verified here: the Swift build of the shim, which needs the Mac. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * POM descriptions for every published module; the release rehearsal in docs/14 (#157) * POM descriptions for every published module; the release rehearsal in docs/14 Each of the 50 published modules now sets `description` next to its `name`, so the POM's <description> (what Central's and Maven's search pages show) says what the module is instead of repeating its name. docs/14 §14.5 records what the practice release run on 2026-11-09 settled: a clean clone tagged v0.2.0 locally staged 62 modules (jar, sources, javadoc, POM, all signed, 56 MB), all 33 external dependencies resolve on Central, and sonaUpload reached VALIDATED (deployment 86b6f4e7, then dropped; nothing published). Also: which account owns net.leibman, where sbt 2 reads credentials, why the release must come from one machine (the Mac), and rehearse-then-Drop. Measured: `show coreJVM/description` etc. print the new descriptions; `sbt --error checkLinux` on this branch (stacked on the thicket_apple.h fix): exit 0, 356 tests passed, 0 failed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Update release instructions for Mac and Linux Clarified release process for Mac and non-Mac hosts, detailing module staging and potential upload collisions. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Change Platform shim kind to match WidgetKind Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Stacked on #156. Rebase onto
mainonce that merges.Change
build.sbt: each of the 50 published modules setsdescriptionnext to itsname. The POM's<description>is what Central's and Maven's search pages show, and until now it was just the module name repeated.docs/14-releasing.md§14.5: a section recording what the 2026-11-09 practice release settled.The practice release (nothing published)
v0.2.0locally, staged 62 modules withpublishSigned; platforms/publishSigned: jar, sources, javadoc and POM, each signed, 56 MB.sonaUploadreached VALIDATED (deployment86b6f4e7). It was then dropped in the Portal. The local tag and clone are deleted.What it settled (now in docs/14)
net.leibmanis owned by an older Sonatype login. A "namespace exists" error means you're in the wrong account.~/.config/sbt/2/. It does not read~/.sbt/1.0/.clipboard-apple,haptics-apple,secrets-apple,share-apple,storage-apple) are staged anyway. A Linux upload plus a Mac upload of the same version would collide on those five.sonaUpload, then Drop.Measured
show coreJVM/description,sbtThicket/description,sqliteAndroid/descriptionandrendererGtk/descriptionprint the new text.sbt --error checkLinuxwith this PR stacked on Regenerate thicket_apple.h: a merge broke it and main's CI #156: exit 0, 356 tests passed, 0 failed.Not checked
docs/14§14.3 and spot checks of the sources. They're worth a read for wording.🤖 Generated with Claude Code