Current OpenAPI doc misses some important section, to ensure its portability - and not limit it to swagger - it should get enhanced.