Create proper README

[lukasz-kaminski]

Also, consider renaming the project to be more descriptive.

[pokerjocke70]

The name is not good. An alternative that we thought of was api-guidelines but the repo is a mix of many things related to our api's. Swagger/OAS specs, postman collections, example code etc ..

Do you have a name that you think is more suitable?

We will for sure update the Readme to be a bit more descriptive

[anderseknert]

Perhaps "api-collection" or "api-offering"? With a README pointing to the various components.