chore: improve and extend README content

[J3m5]

• 📝 Enhanced the README with additional content and sections for better clarity.

• 🐛 Fixed broken links to ensure all references are valid.

• 🎨 Reformatted the document for improved readability.

• 🖼️ Added a custom logo

Check the rendered changes

[github-actions]

Coverage Report

Status	Category	Percentage	Covered / Total
🟢	Lines	71.35% (🎯 70%)	289 / 405
🟢	Statements	71.39% (🎯 70%)	292 / 409
🟢	Functions	71.64% (🎯 70%)	48 / 67
🟢	Branches	59.63% (🎯 58%)	229 / 384

File Coverage

No changed files found.

Generated in workflow #252 for commit 07f2ed3 by the Vitest Coverage Report Action

[Copilot]

Pull Request Overview

This PR overhauls the README to improve clarity, navigation, and completeness by reorganizing the header, adding new sections, and fixing links.

• Introduce a centered title banner with updated badges and quick links.
• Add “Key Features,” expanded installation options (Yarn, Pnpm, Bun), usage examples, and detailed TypeScript definitions.
• Reformat the OpenAPI support details into a rules table and expand sections on contributing, contributors, star history, credits, and license.

[dunglas]

Please remove the HTML. It's useless here and make the file less readable.

[dunglas]

The TOC isn't useful either, it is generated automatically by GitHub and our website.

[J3m5]

The TOC isn't useful either, it is generated automatically by GitHub and our website.

While the TOC is automatically generated by GitHub, it serves as a quick-access navigation shortcut to the most relevant sections.

[J3m5]

Please remove the HTML. It's useless here and make the file less readable.

It just doesn’t look as nice to me

[J3m5]

I've applied your suggestions, @dunglas.
The only HTML left is for the chart history image, since it allows the chart to adapt to dark or light mode based on the user's preference.

[J3m5]

@api-platform/core-team-js

Quick ping: since the last review I’ve made some small changes (usage examples with await + destructured returns, reordered the install section, fixed links, and added a logo).

If there’s anything else you’d like changed before I merge, just let me know.