update open api docs

[de-n3xus]

Environment

Node Version: v20.16.0 Nitro Version: v2.10.4

Reproduction

Go to https://stackblitz.com/edit/github-fvcvgg?file=nitro.config.ts and try to open /_nitro/openapi.json /_nitro/scalar /_nitro/swagger

Describe the bug

Nitro config has enabled openAPI in experimental section, but openapi routes is not found Nothing in logs

/server/api/test.ts contains this

defineRouteMeta({
  openAPI: {
    tags: ["test"],
    description: "Test route description",
    parameters: [{ in: "query", name: "test", required: true }],
  },
});

export default defineEventHandler(() => "OK");

Additional context

No response

Logs

No response

[de-n3xus]

omg https://github.com/nitrojs/nitro/blob/8c934c93ac29bf016858a0a6eff56504821c7b34/src/core/config/resolvers/open-api.ts#L24 https://github.com/nitrojs/nitro/blob/8c934c93ac29bf016858a0a6eff56504821c7b34/src/core/config/resolvers/open-api.ts#L34 https://github.com/nitrojs/nitro/blob/8c934c93ac29bf016858a0a6eff56504821c7b34/src/core/config/resolvers/open-api.ts#L45

why its not in docs...

[Exotelis]

omg

why its not in docs...

You should leave this issue open. I've been scratching my head in confusion for the past two hours.

Thank you for the post, you saved me a lot of time.

[de-n3xus]

omg why its not in docs...

You should leave this issue open. I've been scratching my head in confusion for the past two hours.

Thank you for the post, you saved me a lot of time.

ok i opened it

[Exotelis]

I opened https://github.com/nitrojs/nitro/pull/2869

[pi0]

Thanks for docs PR. Please note that the defaults and behavior might change while this feature is in experimental state (we communicate them via release notes)

[Exotelis]

Thanks for docs PR. Please note that the defaults and behavior might change while this feature is in experimental state (we communicate them via release notes)

This is absolutely fine, but please ensure the documentation stays up to date. It becomes challenging to use features and contribute effectively if the docs are outdated.