docs(all): clarify how to get started

[JonZeolla]

Contributor Comments

This is a documentation PR which improves the README and FAQ to simplify how to get started and separate out follow-on actions.

Pull Request Checklist

Thank you for submitting a contribution!

Please address the following items:

• If you are adding a dependency, please explain how it was chosen.
• If manual testing is needed in order to validate the changes, provide a testing plan and the expected results.
• Validate that documentation is accurate and aligned to any project updates or additions.

[ai-coding-guardrails]

I've got 1 comment for you to consider

The PR title and description are not accurate. Here are my suggestions:

Title: docs(all): restructure and improve README and FAQ documentation

Description: # Contributor Comments

This is a comprehensive documentation PR which significantly improves the README and FAQ to enhance user experience and clarity.

Changes Made:

README.md:

• Restructured content with improved formatting and clearer messaging
• Added centered logo/title for better visual appeal
• Enhanced feature descriptions and streamlined installation instructions into numbered steps
• Reorganized sections for better information flow
• Added guidance for next steps after project generation

FAQ.md:

• Added new FAQ section about version control system support (GitHub-only clarification)
• Improved formatting by breaking long lines for better readability

These changes simplify how users get started while providing better organization and follow-on guidance.

Pull Request Checklist

Thank you for submitting a contribution!

Please address the following items:

• If you are adding a dependency, please explain how it was chosen.
• If manual testing is needed in order to validate the changes, provide a testing plan and the expected results.
• Validate that documentation is accurate and aligned to any project updates or additions.

List of skipped files

• img/ai-native-python.png

Reviewed with 🤟 by Zenable