Refactor README for Better Developer Experience

[danbaruka]

Description

The current README lacks clarity and structure, which can make onboarding and usage more difficult for developers. This issue proposes a full refactor to improve readability, usability, and overall developer experience.

Objectives

• Make the README more beginner-friendly
• Reduce time-to-first-use
• Improve navigation and structure
• Ensure content is up-to-date and consistent

Current Issues

• Missing or unclear project overview
• No clear quick start guide
• Setup instructions are incomplete or scattered
• Lack of code examples
• No clear explanation of dependencies or requirements
• Outdated sections (if applicable)

Proposed Improvements

• Add a clear Project Overview
• Include a Quick Start section (ideally under 5 minutes setup)
• Provide step-by-step Installation and Setup instructions
• Add usage examples with code snippets
• Include a project structure overview
• Add contribution guidelines url

Acceptance Criteria

• A new developer can run the project in under 10 minutes
• README follows a logical, easy-to-scan structure
• All instructions are tested and up to date
• Examples are functional and easy to understand

Bonus (Optional)

• Add badges (build status, license, etc.)
• Include screenshots or diagrams
• Link to additional documentation if needed

Notes

Improving the README is a key step toward making the Cardano ecosystem more accessible and developer-friendly.