Skip to content

docs: sync command count to 71, tighten Why Argus, document rightsize#261

Merged
rlaope merged 1 commit into
masterfrom
docs/sync-71-and-rightsize
May 29, 2026
Merged

docs: sync command count to 71, tighten Why Argus, document rightsize#261
rlaope merged 1 commit into
masterfrom
docs/sync-71-and-rightsize

Conversation

@rlaope
Copy link
Copy Markdown
Owner

@rlaope rlaope commented May 29, 2026

Command-count drift (70 β†’ 71)

A new rightsize command landed, so the documented CLI command count was stale at 70. Updated to 71 everywhere:

  • README.md β€” tagline
  • docs/getting-started.md β€” Java compatibility table
  • docs/README.md β€” reference index
  • docs/cli-commands.md β€” reference intro
  • site/index.html β€” badge + two prose mentions
  • site/commands.html β€” section heading
  • site/reference.html β€” compatibility table + module table

"Why Argus?" compression (README)

Rewrote the README ## Why Argus? highlight list into a tighter, value-first set led by a one-line positioning statement. rightsize is now surfaced as a highlight; snapshot/pool detail was relocated out of the headline list but remains fully documented under docs/.

New rightsize command docs

rightsize was previously undocumented. Added it to:

  • the A–Z index in docs/cli-commands.md (alphabetical, under Runtime & JVM Internals)
  • a full entry in docs/commands/runtime-internals.md matching the page's existing format β€” synopsis, example output, options table, and accurate behavior: recommends -Xmx/-Xms, container memory request/limit, and CPU request from the observed heap high-water-mark / post-GC live-set floor / alloc & promotion rate / metaspace + direct-buffer footprint; never recommends below the live-set floor; the OOMKill-risk tri-state (AT_RISK / OK / UNKNOWN, where UNKNOWN = no observed container limit); --limit=<size>; --format=json; and the GET /fleet/rightsize aggregator roll-up.

Verification

  • Re-scan confirms every count reads 71 with no remaining "70 ... commands".
  • ./gradlew :argus-cli:test --quiet β†’ exit 0.
  • No locale files or gradle.properties touched.

πŸ€– Generated with Claude Code

Bump the documented CLI command count from 70 to 71 across README,
docs, and the site (a new rightsize command was added). Compress the
README "Why Argus?" highlight list into a tighter value-first set, and
fully document the new rightsize command in the CLI reference A-Z index
and the runtime-internals page (synopsis, options, OOMKill tri-state,
JSON output, and the GET /fleet/rightsize aggregator roll-up).

Signed-off-by: rlaope <piyrw9754@gmail.com>
@rlaope rlaope merged commit 81a8e81 into master May 29, 2026
7 checks passed
@rlaope rlaope deleted the docs/sync-71-and-rightsize branch May 29, 2026 03:59
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