[DOCS] Updated README.md

[bbengfort]

Scope of changes

Adds documentation.

Estimated PR Size:

• Tiny
• Small
• Medium
• Large
• Huge

Acceptance criteria

This PR will be merged without review.

Author checklist

• I have manually tested the change and/or added automation in the form of unit tests or integration tests
• I have updated the dependencies list
• I have added new test fixtures as needed to support added tests
• I have added or updated the documentation
• I have run go generate to update generated code

---

Note

Low Risk
Documentation-only changes with no runtime or API impact. Risk is limited to potential user confusion if examples or flags are inaccurate.

Overview
Expands README.md Getting Started to include concrete go:generate enumify examples, how enum values and name tables are discovered ([]string/[][]string), and notes on per-file generation.

Adds a CLI Options section with the current flag help text and a References section linking to relevant generator resources.

^{Reviewed by Cursor Bugbot for commit 5f623a8. Configure here.}