Add a getting started part with an example

[svx]

What is currently missing?

A "Getting started" part where we:

• Have a fake (example) use case
• Docs explaining the next steps
• Have a valid OAS
• Have a spectral example
• Have stunning docs
• Be able to view docs via various tools

Maybe we cloud create an example repo for that Maybe something with FastAPI

How could this be improved?

See above

Is this a feature you would work on yourself?

[X] I plan to open a pull request for this feature

[svx]

Maybe it would be better to add a whole examples as an own repo, or maybe even various repos:

One with FastAPI (uses own included ReDoc)

• we'll use Poetry for the setup
• https://towardsdatascience.com/create-your-first-rest-api-in-fastapi-e728ae649a60
• https://codingnomads.co/blog/python-fastapi-tutorial
• https://www.toptal.com/python/build-high-performing-apps-with-the-python-fastapi-framework
• https://developer.okta.com/blog/2020/12/17/build-and-secure-an-api-in-python-with-fastapi
• https://testdriven.io/blog/fastapi-crud/
• https://www.linode.com/docs/guides/crud-read-operations-use-fastapi-to-write-an-api/
• https://retz.blog/posts/view-and-modify-openapi-documentation-with-fastapi

Second with API under spec and docs

(we need to compile code from spec)