[Docs] Update README: Improve description, layout & formatting

[ikergcalvino]

Summary:

This PR improves the project's README by refining its structure, enhancing readability, and correcting formatting inconsistencies. These changes aim to provide better clarity and a more professional layout for new and existing contributors. It is part of the ongoing improvements discussed in #627.

Changes introduced:

✅ Updated project description to provide a clearer overview.
✅ Improved layout for better readability and structure.
✅ Fixed formatting issues, such as spacing, headings, and lists.

This update enhances the documentation quality, making it more accessible and polished. 🚀

[DaanSelen]

I see the JSON formatting has been sanitized. But regarding the Readme there is visually no difference. Can you elaborate on what the change in the readme is and why?

[ikergcalvino]

Hey! Visually nothing changed, and in GitHub/VSCode the formatting wasn’t an issue, but some Markdown parsers had trouble with certain tags, and also with inconsistent indentation and non-self-closing tags. I cleaned up the structure to follow good practices, improving readability and ensuring better compatibility. Also pulled in the latest changes from main to prevent future merge conflicts (adding the missing Docker Pulls badge + Matrix.org chat link).

[DaanSelen]

Sounds good.

LGTM.