Skip to content

Document the 0.6.0 features and cut the AI tells from README and the site - #48

Merged
JacobPoteet merged 1 commit into
mainfrom
docs/stop-slop-and-0.6.0-features
Aug 23, 2026
Merged

Document the 0.6.0 features and cut the AI tells from README and the site#48
JacobPoteet merged 1 commit into
mainfrom
docs/stop-slop-and-0.6.0-features

Conversation

@JacobPoteet

Copy link
Copy Markdown
Owner

What changed

README.md

  • New feature entries for work shipped in Folder sizes, subfolder navigation, and cross-folder triage #44 that the README never mentioned:
    • Browse in place: Enter/double-click into a folder, back / forward / up, clickable breadcrumb, Alt+arrows and Backspace, and the remembered per-folder selection.
    • Marks that span folders: the toolbar pill (37 marks in 5 folders) with its Discard button, and the commit dialog's per-folder breakdown and scope choice.
    • Folder sizes: what the Size column now shows, why each number costs a tree walk, and the three states that took the most work to get right (link for a junction, no access for a folder Windows refuses, ≥ 4.2 GB for a partial walk).
  • Preview details now lists the folder item count; the build examples drop -Version since build.ps1 reads Directory.Build.props; Tech notes explain the FileSystemEnumerable choice and the session size cache.

docs/index.html

  • Three matching feature cards (Browse in place, Marks that span folders, Folder sizes).
  • The app mock catches up with the real UI: a location bar with back/forward/up and a clickable breadcrumb, a pending-marks pill, real sizes in the Size column (including a partial 870 MB…), and v0.6.0 on the update pill.
  • Build snippet no longer pins a version.

Both files, pass for AI writing patterns

  • Em dashes out of prose; label separators are colons now.
  • Superlatives and filler adverbs cut: "the fastest way to", "without ever leaving", "actually", "simply".
  • Rhetorical questions and staccato headings rewritten: "Swipe. Swipe. Done." → "Swipe through a folder", "Everything you need to triage a folder" → "What it does", "From cluttered to clean in four steps" → "How a pass goes", "Changed your mind? … no digging required" → a plain statement.

Why

Three of the four things a new user notices first (folder sizes, subfolder navigation, marks that survive a trip to another folder) shipped in #44 and appeared in neither the README nor the site, so both described the app as it was at 0.5.0.

Notes for a reviewer

🤖 Generated with Claude Code

…site

The README and the landing page still described the app as it was before
#44: no folder sizes, no subfolder navigation, and triage marks that died
with the folder they were made in. Three of the four things a new user
would notice first were missing.

README gains browse-in-place (Enter/double-click, back/forward/up, the
breadcrumb, Alt+arrows), marks that span folders (the toolbar pill and
the commit dialog's per-folder scope), and folder sizes including the
states that took the most work to get right - "link" for a junction,
"no access" for a folder Windows refuses, and a floor rather than a
total when a walk was partial. Preview details gained the folder item
count, the build examples dropped -Version now that build.ps1 reads
Directory.Build.props, and Tech notes explain why the walk uses
FileSystemEnumerable.

The landing page gets matching cards, and its mock catches up with the
UI: a location bar with back/forward/up and a clickable breadcrumb, a
pending-marks pill, real sizes in the Size column, and v0.6.0 on the
update pill.

Both files also got a pass for AI writing patterns: em dashes out of
prose, superlatives and filler adverbs cut ("the fastest way to",
"without ever leaving", "actually", "simply"), rhetorical questions and
staccato headings rewritten ("Swipe. Swipe. Done." -> "Swipe through a
folder"). The em dashes left in docs/index.html are inside the mock,
where they reproduce strings the app really prints.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@JacobPoteet
JacobPoteet merged commit ade5df4 into main Aug 23, 2026
1 check passed
@JacobPoteet
JacobPoteet deleted the docs/stop-slop-and-0.6.0-features branch August 23, 2026 02:48
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.

1 participant