Aligning the README with the Python's one

[Giom-V]

Description of the change

Aligning the README with the Python's one

Motivation

To uniformise of documentation and making it both easier to understand to devs and easier to maintain for us.

Type of change

Choose one: Documentation

Checklist

• [X] I have performed a self-review of my code.
• [X] I have added detailed comments to my code where applicable.
• [X] I have verified that my change does not break existing code.
• [X] My PR is based on the latest changes of the main branch (if unsure, please run git pull --rebase upstream main).
• [X] I am familiar with the Google Style Guide for the language I have coded in.
• [X] I have read through the Contributing Guide and signed the Contributor License Agreement.