Updating the readme for clarity (pre-MCP) (#2918)

This pull request significantly improves the `README.md` by
restructuring and expanding the documentation.

---------

Co-authored-by: Copilot <[email protected]>

Author: JerryNixon