Skip to content

docs: session recording doc improvements#2266

Merged
nickytonline merged 11 commits into
mainfrom
nickytonline/session-recording-refactor
Jun 18, 2026
Merged

docs: session recording doc improvements#2266
nickytonline merged 11 commits into
mainfrom
nickytonline/session-recording-refactor

Conversation

@nickytonline

@nickytonline nickytonline commented Jun 11, 2026

Copy link
Copy Markdown
Member

Summary

Some copy cleanup in terms of explaining some acronymns and the bigger rework is giving the session recording auditing and session recording storage their own pages. I also changed the images to light theme as they show up better for docs.

preview page at https://deploy-preview-2266--pomerium-docs.netlify.app/docs/capabilities/session-recording

Snapzy_2026-06-18_17-01-08_157

Related

Relates to #2214

AI disclosure

Devin with Kimi K2.6 was used to seperate out the pages and update a bit of copy, e.g. expand acronyms. I reviewed the changes. I also made some manual changes including replacing dark mode screenshots with light themed ones as they look better.

Checklist

  • reference any related issues
  • updated docs
  • updated UPGRADING.md
  • updated CHANGELOG.md
  • disclosed AI usage (or wrote "none") per AI_POLICY.md

@netlify

netlify Bot commented Jun 11, 2026

Copy link
Copy Markdown

Deploy Preview for pomerium-docs ready!

Name Link
🔨 Latest commit 925edfe
🔍 Latest deploy log https://app.netlify.com/projects/pomerium-docs/deploys/6a345d94c13c6c00088c0379
😎 Deploy Preview https://deploy-preview-2266--pomerium-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@nickytonline nickytonline force-pushed the nickytonline/session-recording-refactor branch 3 times, most recently from a8f82a1 to 1ecb021 Compare June 11, 2026 22:10
@nickytonline nickytonline marked this pull request as ready for review June 11, 2026 23:22
@nickytonline nickytonline requested a review from a team as a code owner June 11, 2026 23:22
@nickytonline nickytonline requested review from alexandreLamarre, kralicky and nikhil-pomerium and removed request for a team June 11, 2026 23:22
@nickytonline nickytonline force-pushed the nickytonline/session-recording-refactor branch from 5bf6bc0 to 7606ccf Compare June 12, 2026 00:01
@nickytonline nickytonline requested a review from kenjenkins June 12, 2026 00:26
Comment thread content/docs/capabilities/session-recording.mdx Outdated
Comment thread content/docs/capabilities/session-recording/auditing.mdx
nickytonline and others added 8 commits June 18, 2026 16:26
Extract Storage Configuration provider tables and credential setup
into a new reference doc (session-recording-storage.mdx).

Extract Auditing, integrity checks, and audit log correlation
queries into a new internals doc (session-recording-auditing.mdx).

Trim session-recording.mdx to focus on the procedural setup flow:
- Add "Verify Your Setup" section with 3 concrete checkpoints
- Add "Operations" section covering disabling, extension removal,
  bucket rotation, and shared secret rotation
- Link to extracted docs where deep reference material was removed

Generated with [Devin](https://cli.devin.ai/docs)

Co-authored-by: Devin (Kimi K2.6) <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@nickytonline nickytonline force-pushed the nickytonline/session-recording-refactor branch from 59af36c to 9dbc525 Compare June 18, 2026 20:26
…tion

Move session-recording-storage and session-recording-auditing from
reference/ and internals/ into capabilities/session-recording/ so all
Session Recording pages live in the same sidebar section. Update
sidebars.js to use autogenerated children like the MCP category.
Also fix gtag plugin initialization when GA/GA4 env vars are unset.

Co-Authored-By: Devin (Kimi K2.6) <158243242+devin-ai-integration[bot]@users.noreply.github.com>
nickytonline and others added 2 commits June 18, 2026 17:04
The .enterprise a:before rule matched all links inside an enterprise
category, including nested child items. Use direct-child selectors so
the ENT pill only appears on the category header and standalone doc
items, not on autogenerated sub-pages.

Co-Authored-By: Devin (Kimi K2.6) <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@nickytonline nickytonline merged commit 87ab5e9 into main Jun 18, 2026
9 checks passed
@nickytonline nickytonline deleted the nickytonline/session-recording-refactor branch June 18, 2026 21:08
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.

2 participants