[DOC] Update readme to follow new template

[beeme1mr]

Change in the documentation

Update the readme to follow the new template. Once this is ready, the documentation can be configured to pull from the repo automatically.

Examples from other repos:

• https://github.com/open-feature/java-sdk
• https://github.com/open-feature/js-sdk/tree/main/packages/client

[beeme1mr]

@tcarrio if I get this started, would you be able to fill in the code examples?