Improve readme for AI agentic coding

The aim of this PR is to provide a single `README.md` file that can be easily pasted into system prompts so AI coding agents (e.g., ChatGPT) can immediately understand how to use the crate. To achieve this, this update compiles all the existing code examples scattered throughout the source code into one cohesive and comprehensive `README.md` file. This creates exhaustive documentation of the crate's API in a single, easy-to-navigate document, making it simpler for both humans and LLMs to explore and apply the crate effectively.