[Regression from `v3.0.1`][OpenAPI doc generation] In the latest build of the `main` branch, `v3.0.1+26-dc1f3f41-SNAPSHOT`, the generated OpenAPI doc doesn't include the endpoint documentation anymore

[jivanic-demystdata]

I tried to update to the latest build to see if it'd fix an issue we have. When I regenerated my TypeScript SDK from the generated OpenAPI documentation, all the documentation in the TS SDK is disappearing.

For the following endpoint:

  val `POST /source-templates`
    : Endpoint[Unit, SourceTemplateInput, CreateSourceTemplateError, SourceTemplateEntityOutput, AuthType.Bearer] =
    (Endpoint(RoutePattern.POST / "source-templates") ?? Doc.p("Create a Source Template"))
      .outErrors[CreateSourceTemplateError](
        HttpCodec.error[CreateSourceTemplateError.InternalServerError](zio.http.Status.InternalServerError) ?? Doc.p("Not Found"),
        HttpCodec.error[CreateSourceTemplateError.OtherError](zio.http.Status.InternalServerError) ?? Doc.p("Other error"),
      )
      .in[SourceTemplateInput](mediaType = MediaType.application.json, doc = Doc.p("The Source Template to create"))
      .out[SourceTemplateEntityOutput](mediaType = MediaType.application.json, doc = Doc.p("The created Source Template"))
      .auth(AuthType.Bearer)

With v3.0.1, the OpenAPI doc does correctly include the "Create a Source Template" documentation:

While with the latest build from the main, v3.0.1+26-dc1f3f41-SNAPSHOT, it disappears:

This result in the following change in my generated TS SDK:

The regression might come from these changes: https://github.com/zio/zio-http/pull/3147

[jdegoes]

/bounty $75 for fix and regression test

[algora-pbc[bot]]

💎 $75 bounty • ZIO

Steps to solve:

1. Start working: Comment /attempt #3198 with your implementation plan
2. Submit work: Create a pull request including /claim #3198 in the PR body to claim the bounty
3. Receive payment: 100% of the bounty is received 2-5 days post-reward. Make sure you are eligible for payouts

Thank you for contributing to zio/zio-http!

Add a bounty • Share on socials

Attempt	Started (GMT+0)	Solution
🟢 @mobley-trent	Nov 26, 2024, 10:20:20 AM	#3221

[mobley-trent]

/attempt #3198

Algora profile	Completed bounties	Tech	Active attempts	Options
@mobley-trent	1 ZIO bounty + 10 bounties from 4 projects	Python, Rust, Go & more		Cancel attempt

[algora-pbc[bot]]

💡 @mobley-trent submitted a pull request that claims the bounty. You can visit your bounty board to reward.