explain level options with examples

[asmacdo]

Closes #338

[Copilot]

Pull request overview

This PR adds comprehensive documentation for the --log-level option by providing a dedicated "Log Levels" section with usage guidance and practical examples. This addresses issue #338 by making it easier for users to understand when and how to use different log levels.

Changes:

• Renamed "Command Reference" heading to "Reference" for brevity
• Added "Log Levels" section with a table describing when to use each level
• Provided three concrete examples showing INFO (default), NONE, and DEBUG output

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 91.38%. Comparing base (f35633e) to head (e094b3d).

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #369   +/-   ##
=======================================
  Coverage   91.38%   91.38%           
=======================================
  Files           8        8           
  Lines        1056     1056           
  Branches      138      138           
=======================================
  Hits          965      965           
  Misses         69       69           
  Partials       22       22           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.