docs: add Quick Start Guide section to README#515
docs: add Quick Start Guide section to README#515vincent067 wants to merge 2 commits intorobusta-dev:mainfrom
Conversation
- Added a new 'Quick Start Guide' section after 'About The Project' - Provides simple 3-step instructions for new users to get started - Helps users get up and running in under 5 minutes This improves the onboarding experience for new users.
|
Alex Chen seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account. You have signed the CLA already but the status is still pending? Let us recheck it. |
WalkthroughThe README now includes a "Quick Start Guide" section documenting installation and setup instructions via both pip and Homebrew package managers, demonstrating how to install KRR, verify the installation, and run an initial scan. Changes
Estimated code review effort🎯 1 (Trivial) | ⏱️ ~3 minutes Suggested reviewers
🚥 Pre-merge checks | ✅ 3✅ Passed checks (3 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
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. Comment |
- Added a new 'Quick Start Guide' section after 'About The Project' - Provides simple 3-step instructions for new users to get started - Helps users get up and running in under 5 minutes This improves the onboarding experience for new users.
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@README.md`:
- Around line 135-149: Remove the duplicate "## Quick Start Guide" heading and
merge the Homebrew instructions under the existing Quick Start section by
turning the Homebrew block into a subordinate heading (e.g., "### Alternative
Install (Homebrew)") and keeping only the Homebrew install commands in that
block (brew tap robusta-dev/homebrew-krr; brew install krr); then ensure the
verification ("krr version") and first-scan ("krr simple") steps remain once,
after the install alternatives, so the flow is: main Quick Start heading →
primary install steps → "Alternative Install (Homebrew)" with just the brew
commands → verification and first scan.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
| ## Quick Start Guide | ||
|
|
||
| Get started with KRR in under 5 minutes: | ||
|
|
||
| ```bash | ||
| # Install with Homebrew | ||
| brew tap robusta-dev/homebrew-krr | ||
| brew install krr | ||
|
|
||
| # Verify installation | ||
| krr version | ||
|
|
||
| # Run your first scan | ||
| krr simple | ||
| ``` |
There was a problem hiding this comment.
Remove duplicate Quick Start Guide heading and merge install paths.
Line 135 introduces a second ## Quick Start Guide, which triggers MD024 and makes onboarding repetitive. Keep one heading and present Homebrew as an alternative install option under the same section.
Proposed cleanup
-## Quick Start Guide
-
-Get started with KRR in under 5 minutes:
-
-```bash
-# Install with Homebrew
-brew tap robusta-dev/homebrew-krr
-brew install krr
-
-# Verify installation
-krr version
-
-# Run your first scan
-krr simple
-```
+### Alternative Install (Homebrew)
+
+```bash
+brew tap robusta-dev/homebrew-krr
+brew install krr
+```
+
+Then continue with verification and first scan from the steps above.🧰 Tools
🪛 markdownlint-cli2 (0.22.0)
[warning] 135-135: Multiple headings with the same content
(MD024, no-duplicate-heading)
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@README.md` around lines 135 - 149, Remove the duplicate "## Quick Start
Guide" heading and merge the Homebrew instructions under the existing Quick
Start section by turning the Homebrew block into a subordinate heading (e.g.,
"### Alternative Install (Homebrew)") and keeping only the Homebrew install
commands in that block (brew tap robusta-dev/homebrew-krr; brew install krr);
then ensure the verification ("krr version") and first-scan ("krr simple") steps
remain once, after the install alternatives, so the flow is: main Quick Start
heading → primary install steps → "Alternative Install (Homebrew)" with just the
brew commands → verification and first scan.
Hi there! 👋
This PR adds a Quick Start Guide section to the README to help new users get started with KRR more quickly.
Changes:
I hope this helps make the project more accessible to new users! 😊
Please let me know if you would like any adjustments.
Thanks for maintaining this awesome project! 🙏