Improve README for clarity, consistency, and formatting

[yfenes]

Change Summary

What and Why:

• Improve heading levels and consistency in the Readme
• Correct minor grammatical errors

How:

• Updating readme

---

Documentation

• [ ] Fresh Produce
• [ ] In superfly/docs, or asked for help from docs team
• [ ] n/a