misc improvements

[Alexandre-Herve]

🍗 Description

What does this PR do? Anything folks should know?

misc improvements and a bug fix

Optic matched 2 OpenAPI specification files:
todo-api.yaml, todo-api3.yaml.

✔ Select the organization that your APIs belong to. Use an organization token to disambiguate in non interactive environments. › My organization

--------------------------------------------------------------------------------------------------

 ┌─────────────────────────────────┐
 │  [1]      Optic Cloud      [2]  │
 └───┬─────────────────────────▲───┘
     │Compare            Update│
 ┌───▼─────────────────────────┴───┐
 │           Local specs           │
 └─────────────────────────────────┘

 [1]: Comparing your local specifications to their latest `gitbranch:test` version in Optic cloud.
      (Optic compares against the target branch tag upon a PR/MR event, and the current branch tag otherwise)

 [2]: Pushing local specs as latest versions for `gitbranch:test` in Optic cloud.
      (Updating the current branch tag)

--------------------------------------------------------------------------------------------------

| TodoAPI (todo-api.yaml)
| ☑️  No changes ❌ 8 design issues 
| View report: http://localhost:3001/organizations/c85230f7-4422-476a-8cbf-2a99ce0e5b8e/apis/e9SJK_mMiQ_eK2Cd00z6b/runs/GI9mHxOqQuoccqliq1WPD

| TodoAPI (todo-api3.yaml)
| ☑️  No changes ❌ 6 design issues 
| View report: http://localhost:3001/organizations/c85230f7-4422-476a-8cbf-2a99ce0e5b8e/apis/K5DnCDr5ykIlZRG9TQe-G/runs/E6GpoeDo_YwK0JVh-09uG

Exiting with code 1 as errors were found. Disable this behaviour with the `--severity none` option.

📚 References

Links to relevant docs (Notion, Twist, GH issues, etc.), if applicable.

👹 QA

How can other humans verify that this PR is correct?