Finalising annotation generation before annotating first plugins

[snake14]

Description

Make various improvements in the annotation generation including fixing some issues. This will allow most examples to be included and most responses typed.

Issue No

PG-4544

Steps to Replicate the Issue

1. Check out the latest version of the CustomReports plugin
2. Run the command to generate the annotations: ddev matomo:console openapidocs:generate-annotations --plugin=CustomReports --not-dry-run
3. Run the command to generate the spec file: ddev matomo:console openapidocs:generate-spec-file --plugin=CustomReports --not-dry-run
4. Open the spec file at plugins/CustomReports/OpenApi/Specs/CustomReports_v1.0.0.json and preview in PHPStorm to see the SwaggerUI presentation with almost all parameters and responses fully typed (A CustomReports PR is making a few changes to allow even better results).

Checklist

• [✔] Tested locally or on demo2/demo3?
• [✖] New test case added/updated?
• [NA] Are all newly added texts included via translation?
• [NA] Are text sanitized properly? (Eg use of v-text v/s v-html for vue)
• [✖] Version bumped?

[AltamashShaikh]

Left couple of comments, rest looks good to me.