Improve the README.

Maybe we should specifically explain two use-cases:

• split an existing OpenAPI definition
• start a new OpenAPI definition

And then better explain the structure of the resulting split repository?