docs: Improve README wording and consistency

[GarimaDixit2502]

Summary

This PR improves the clarity, grammar, and consistency of the README documentation. The changes are purely textual and do not affect any functionality, commands, or project behavior.

Changes Made

• Corrected minor grammar and punctuation issues.
• Improved wording for better clarity and readability.
• Standardized terminology and phrasing across documentation sections.
• Refined a few sentences in CLI and troubleshooting descriptions for consistency.

Rationale

These updates aim to enhance the readability and professional quality of the documentation while ensuring all technical details, commands, and links remain unchanged.

Impact

• No functional or behavioral changes to the project.
• No modifications to scripts, workflows, or configuration files.
• Documentation-only improvements.

Verification

• Manually reviewed the updated README for correctness and consistency.
• Confirmed that all commands, URLs, and technical instructions remain intact.

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Documentation-only PR that cleans up README wording and formatting to improve clarity and consistency for users.

Changes:

• Normalized punctuation/wording across the intro and “How It Works” sections.
• Clarified some option descriptions (org scoping, sorting detail, PAT wording).
• Minor Markdown formatting tweaks (indentation, spacing).

---

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