Skip to content

docs: add membership audit log how-to - #507

Merged
mbevc1 merged 1 commit into
mainfrom
autopilot/2b7d32b4
Nov 6, 2026
Merged

docs: add membership audit log how-to#507
mbevc1 merged 1 commit into
mainfrom
autopilot/2b7d32b4

Conversation

@mintlify

@mintlify mintlify Bot commented Nov 6, 2026

Copy link
Copy Markdown
Contributor

Adds a how-to for the Audit Log page under User Management (columns, search, Event/Role/Source filters, date range); GA: no feature flag in the current code, admin-only.

Based on Membership audit log.

@mintlify
mintlify Bot requested a review from a team as a code owner November 6, 2026 10:30
@mintlify
mintlify Bot requested a review from dangrondahl November 6, 2026 10:30
@mintlify

mintlify Bot commented Nov 6, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
kosli 🟢 Ready View Preview Nov 6, 2026, 10:30 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

@claude

claude Bot commented Nov 6, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Claude finished @mintlify[bot]'s task in 37s —— View job

Doc review: docs: add membership audit log how-to

Both internal links on the new page resolve (/administration/managing_users/roles_in_kosli, /administration/managing_users/automated_user_provisioning). The page is listed in config/navigation.json under Platform administration › Users and access › Users and roles, which is the right tab and group for an admin how-to.

administration/managing_users/roles_in_kosli.md (not in this PR, but inconsistent with it)

Improvement: Location: administration/managing_users/roles_in_kosli.md:222
Issue: The new page sends admins to Settings › User Management (membership_audit_log.md:16), and the changelog says the same (changelog/index.mdx:1096). The "Assigning roles" procedure on the roles page still says Go to `Settings` > `Members` . A reader who moves between the two pages finds two different names for the same settings area, and at least one of them is wrong.
Recommendation: Confirm the current label in the app. If it is User Management, update step 3 on the roles page in this PR so the two pages agree. Fix this →

Suggestion: Location: administration/managing_users/roles_in_kosli.md:242-258
Issue: The "Regular access reviews" best practice is exactly the job the new page supports, but neither that section nor "See also" links to it. Readers who arrive at the roles page won't find the audit log.
Recommendation: Add a sentence such as "Use the Audit Log to see who changed membership and when." to "Regular access reviews", and add the page to "See also". Fix this →

1 Improvement, 1 Suggestion, 0 Critical. This review is advisory, and nothing here blocks the merge.

@mbevc1
mbevc1 merged commit 8514545 into main Nov 6, 2026
6 checks passed
@mbevc1
mbevc1 deleted the autopilot/2b7d32b4 branch November 6, 2026 10:34
@mintlify
mintlify Bot restored the autopilot/2b7d32b4 branch November 6, 2026 10:36
@mintlify mintlify Bot mentioned this pull request Nov 7, 2026
Merged
AlexKantor87 pushed a commit that referenced this pull request Nov 7, 2026
@mintlify
fix: apply review follow-ups for service accounts, tags and audit log…
0225846 
… pages (#511)

Applies the open review findings from #505, #506 and #507: the roles
page now uses the Settings > User Management label, the tags page covers
controls (beta) and reading tags with the CLI, and the service accounts
page covers listing and revoking keys.

Based on [#505](#505),
[#506](#506) and
[#507](#507).

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

This branch was successfully deployed

1 active deployment
staging — 06fbb95c Deployed Nov 6, 2026 by mintlify[bot]
View deployment
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@mbevc1 mbevc1 mbevc1 approved these changes
@dangrondahl dangrondahl Awaiting requested review from dangrondahl

Assignees

@dangrondahl dangrondahl

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@mbevc1 @dangrondahl