Skip to content

Fix documentation inaccuracies - #453

Merged
ravjotbrar merged 3 commits into
mainfrom
docs/fix-dashboard-description
Aug 7, 2026
Merged

ravjotbrar merged 3 commits into
mainfrom
docs/fix-dashboard-description

Conversation

@ravjotbrar

@ravjotbrar ravjotbrar commented Aug 6, 2026

Copy link
Copy Markdown
Collaborator

Audit and fix inaccuracies across the documentation site.

File Fix
send-command.md 257 → 396 commands
cluster-topology.md "Key Count" → "Memory", "Connections" → "Connected Clients", "Grid" → "Dashboard"
key-browser.md Removed non-existent "List View" and "Sorting" features
connections.md Clarified DB field is always disabled for discovery endpoints, not version-dependent
dashboard.md Rewrote "Cluster Health" section with accurate stat cards and metric groups
metrics.md Removed unsupported sentinel mode, fixed port default from 3000 to 0
kubernetes.md All k8s/ paths → examples/k8s/ (10 occurrences)
limitations.md "targeted lookup" → "SCAN with a MATCH pattern"
server.md Clarified WS origins: same-origin always enforced, variable adds extras

…ment, and reference pages

Signed-off-by: ravjotb <ravjot.brar@improving.com>
@coderabbitai

coderabbitai Bot commented Aug 6, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 02a17772-bab7-4dfd-921b-20d1bd85350e

📥 Commits

Reviewing files that changed from the base of the PR and between 9dded6c and afb000e.

📒 Files selected for processing (1)
  • docs-site/src/content/docs/features/dashboard.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs-site/src/content/docs/features/dashboard.md

📝 Walkthrough

Walkthrough

The documentation updates align configuration defaults, WebSocket origin rules, Kubernetes manifest paths, feature descriptions, command counts, and Key Browser search behavior with current implementation details.

Changes

Documentation updates

Layer / File(s) Summary
Configuration behavior documentation
docs-site/src/content/docs/configuration/metrics.md, docs-site/src/content/docs/configuration/server.md
Metrics documentation now uses port 0, removes the sentinel mode, and documents WebSocket origin validation for Web and Electron deployments.
Kubernetes manifest references
docs-site/src/content/docs/deployment/kubernetes.md
Deployment, development, troubleshooting, and notes sections now reference manifests under examples/k8s/.
Feature behavior documentation
docs-site/src/content/docs/features/cluster-topology.md, docs-site/src/content/docs/features/connections.md, docs-site/src/content/docs/features/dashboard.md, docs-site/src/content/docs/features/key-browser.md
Feature pages now describe current node metrics, dashboard metrics, discovery database behavior, and Key Browser features.
Command and limitation references
docs-site/src/content/docs/features/send-command.md, docs-site/src/content/docs/reference/limitations.md
The documented command count is updated to 396, and Key Browser search is documented as SCAN with a MATCH pattern.

Possibly related PRs

Suggested reviewers: arseny-kostenko

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely summarizes the primary change: correcting inaccuracies across the documentation site.
Description check ✅ Passed The description provides a clear summary and file-level change list, but it omits the optional before-and-after visualization.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs-site/src/content/docs/configuration/server.md`:
- Around line 70-76: Update the Web mode/Electron mode description and the
Default entry in the WebSocket trusted-origins documentation to reflect
websocket-origin validation: missing origins are rejected, packaged Electron and
loopback origins are allowed, other remote origins are rejected, and configured
origins remain allowed in both modes. Remove the claim that Electron skips
origin checking entirely.

In `@docs-site/src/content/docs/deployment/kubernetes.md`:
- Line 54: Update the non-local deployment instructions to also change
imagePullPolicy in examples/k8s/app.yaml and
examples/k8s/valkey-statefulset-sidecar-patch.yaml: use IfNotPresent with
immutable image tags and Always with mutable image tags instead of Never.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 72655671-305c-44e2-8b88-a10d586f4128

📥 Commits

Reviewing files that changed from the base of the PR and between b16009f and b685bbc.

📒 Files selected for processing (9)
  • docs-site/src/content/docs/configuration/metrics.md
  • docs-site/src/content/docs/configuration/server.md
  • docs-site/src/content/docs/deployment/kubernetes.md
  • docs-site/src/content/docs/features/cluster-topology.md
  • docs-site/src/content/docs/features/connections.md
  • docs-site/src/content/docs/features/dashboard.md
  • docs-site/src/content/docs/features/key-browser.md
  • docs-site/src/content/docs/features/send-command.md
  • docs-site/src/content/docs/reference/limitations.md
💤 Files with no reviewable changes (1)
  • docs-site/src/content/docs/features/key-browser.md

Comment thread docs-site/src/content/docs/configuration/server.md Outdated
```

For a non-local deployment, use published images from a container registry and update the image references in `k8s/app.yaml` and `k8s/valkey-statefulset-sidecar-patch.yaml`.
For a non-local deployment, use published images from a container registry and update the image references in `examples/k8s/app.yaml` and `examples/k8s/valkey-statefulset-sidecar-patch.yaml`.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail
rg -n -C 2 'imagePullPolicy|image:' \
  examples/k8s/app.yaml \
  examples/k8s/valkey-statefulset-sidecar-patch.yaml

Repository: valkey-io/valkey-admin

Length of output: 947


🏁 Script executed:

#!/bin/bash
set -euo pipefail
sed -n '45,70p' docs-site/src/content/docs/deployment/kubernetes.md

Repository: valkey-io/valkey-admin

Length of output: 998


Include imagePullPolicy in the non-local image instructions.

examples/k8s/app.yaml and examples/k8s/valkey-statefulset-sidecar-patch.yaml both set imagePullPolicy: Never, so registry images are not pulled. Tell users to update the policy when changing the image references: use IfNotPresent for immutable image tags and Always for mutable image tags.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs-site/src/content/docs/deployment/kubernetes.md` at line 54, Update the
non-local deployment instructions to also change imagePullPolicy in
examples/k8s/app.yaml and examples/k8s/valkey-statefulset-sidecar-patch.yaml:
use IfNotPresent with immutable image tags and Always with mutable image tags
instead of Never.

Signed-off-by: ravjotb <ravjot.brar@improving.com>

- **Memory Usage Metrics**: Breakdown of memory allocation (dataset, scripts, peak, overhead, etc.)
- **Uptime Metrics**: Server uptime, evicted scripts, network I/O bytes
- **Replication & Persistence**: RDB save status, replication backlog, sync state

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: Would it be beneficial to explain what it is?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good idea. Added descriptions instead of just the different types of metrics.

Signed-off-by: ravjotb <ravjot.brar@improving.com>
@github-actions github-actions Bot added the area/docs Documentation site label Aug 7, 2026
@ravjotbrar
ravjotbrar merged commit 7ecf31c into main Aug 7, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/docs Documentation site

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants