chore: update changelog CLI v2.39.0/v2.39.1 and Platform updates - #376
Conversation
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
|
Claude finished @dangrondahl's task in 1m 58s —— View job Doc review
No findings clear the bar on this push. The three rounds of feedback on this PR are resolved at head: the SCIM entries are gone (only the pre-existing Cross-file checks that mattered here, and what they returned:
The two reference-page gaps agreed as follow-up work — missing-operand semantics and override handling in One caveat on rule 5: |
- Move the SCIM user-management bullet under "Breaking changes": it removes a capability from the UI for affected admins. - Split the opt-in toggle detail into its own "Updates" bullet, shortening the longest bullet in the file. - Capitalize "Audit Log" as the page name instead of generic "audit log". - Fix British "serialised" -> "serialized".
e582489 to
3f41d39
Compare
The August 28 changelog entry announces that the org-level opt-in setting for Spaces is gone, but the tutorial still listed enabling it as step 3 -- a dead prerequisite that would make a reader conclude Spaces is unavailable. - Remove the step and renumber. - Drop the "Currently" hedge on availability, which described the gated state. - Link the tutorial from the changelog bullet.
SCIM has no dedicated documentation page, so per review these entries have nowhere to send a reader and should not ship until that page exists. The work is tracked separately.
## Summary Adds the changelog entry for CLI **v2.39.2**, plus the Docker image version fix from v2.39.0 that was missing. Rebased on `main` after #376 merged. #376 had already documented v2.39.0 and v2.39.1, so this PR is now purely additive — no deletions. ## Conflict resolution Four conflicts in `changelog/index.mdx`, resolved as follows: - **v2.39.2** — new, kept as generated. Placed above the August 31 Platform entry, keeping the file newest-first. - **v2.39.0 and v2.39.1 prose** — kept the versions already on `main` from #376 and discarded this branch's rewordings, since they had been through review and use the correct command name (see below). - **The August 24–28 Platform entries** — kept `main`'s; this branch predated them. ## The Docker version fix This branch carried a Docker version bullet on both v2.39.0 and v2.39.1, and `main` had neither. Checking upstream, only one of them is a user-facing fix: - **v2.39.0** ([cli#1137](kosli-dev/cli#1137)) — the real fix. Published images identified themselves as `dev+<sha>` instead of their release tag, so `kosli version` in a container could not name the release. Two causes in the Docker build path, both silent. Any image published before v2.39.0 is affected. **Kept**, reworded around that symptom. - **v2.39.1** ([cli#1140](kosli-dev/cli#1140)) — not a user-facing fix. It resolves the version once in the workflow instead of via `git describe` in the build, superseding cli#1137's `fetch-tags` approach, and fixes a smoke-test flake when a release tag is cut at the same commit as an in-flight main pipeline. Its own description says images "report what they did before … except the racy case". **Dropped** as an internal build change. That also removes the problem of two consecutive releases each claiming to fix the image version with different causes. Both bullets appeared only in the releases' "What's Changed" lists rather than their curated sections, which is likely why the first pass missed them. ## One correction worth noting This branch described the v2.39.1 help-text change as affecting `kosli snapshot azure-apps`. That name comes from the upstream release note, but the command is `kosli snapshot azure` — the generated reference page is `client_reference/kosli_snapshot_azure.md` and there is no `azure-apps` page. `main`'s wording is correct and links the reference; that is what was kept. ## Checks - `mint broken-links` — clean apart from the pre-existing `/getting_started/service-accounts` break in `tutorials/working_with_controls.mdx`, which is on `main` and untouched here. - `<Update>` open/close tags balance at 117 each; no empty headings; entries remain in newest-first date order. --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Dan Grøndahl <dan@kosli.com>
Summary
Adds changelog entries for releases published Aug 24–31: CLI v2.39.0 and v2.39.1, plus Platform changes shipped from the server.
Changes
--sonar-branchflag, clearer Jira credential handling,--jira-project-keywhitespace tolerance,.kosli_ignorehelp text.