update README.md

[MuhmdRaouf]

Description

This PR addresses several issues in the README.md file:

• Fixed Syntax Errors: Corrected code snippets and text syntax errors to improve readability and accuracy.
• Added Missing Types: Included missing types in code examples to ensure consistency and clarity, making it easier for developers to understand and implement.

CHANGELOG

• [CHANGED] Enhance the overall quality and usability of the documentation.

[Keith-wright]

Hey @MuhmdRaouf — before we can review and merge this, could you rebase onto the latest master? Some of your other contributions have since been merged (including #165), so there will be a few conflicts to work through.

Thanks!