docs: update README for Pydantic migration

- Add "Working with Pydantic Models" section with model_dump() and
  model_dump_json() examples
- Update all examples to use snake_case field names
- Simplify examples using f-strings and direct field access
- Fix typos and clean up language
- Add note about Pydantic in Getting Started section

Author: Mattsface