Skip to content

docs(readme): show what a scan actually looks like - #101

Merged
Muawiya-contact merged 1 commit into
mainfrom
docs/readme-screenshot
Sep 7, 2026
Merged

docs(readme): show what a scan actually looks like#101
Muawiya-contact merged 1 commit into
mainfrom
docs/readme-screenshot

Conversation

@Muawiya-contact

Copy link
Copy Markdown
Member

What & why

The README describes the output in prose and never shows it, so "what do
I actually get when I run this" took a clone and a build to answer. The
repo had no images at all.

This adds one: real diskern scan output from v0.2.0, run against a
sample home directory with browser and package caches, a live project
whose node_modules is still referenced, an abandoned target/,
duplicate installers and a stale log. Not a mockup — the binary was built
from the tag and the output captured.

The caption explains the 0 B on the risky rows, which reads as a bug
until you know reclaimable excludes files nothing will offer to move
(see #100 for whether the CLI should show the real size there instead).

Validation

  • Image is 1236×1002, 233 KB.
  • git diff --check clean.

Checklist

  • Commits are small and focused (one logical change each)
  • Doesn't weaken a safety principle (read-only scans, quarantine over deletion, deterministic verdicts)
  • Docs-only change, so the Rust gates are unaffected

The README described the output in prose and never showed it, so the
first question a visitor has — what do I get when I run this — took a
clone and a build to answer.

Real output from v0.2.0 against a sample home directory, not a mockup.
The caption explains the 0 B on the risky rows, which reads as a bug
until you know reclaimable excludes files nothing will act on.
@Muawiya-contact Muawiya-contact added the documentation Improvements or additions to documentation label Sep 7, 2026

@Muawiya-contact Muawiya-contact left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

ok

@Muawiya-contact
Muawiya-contact merged commit 997aad1 into main Sep 7, 2026
10 checks passed
@Muawiya-contact
Muawiya-contact deleted the docs/readme-screenshot branch September 7, 2026 07:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant