[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: #3147

[jdegoes]

/bounty $75 for fix and regression test

[algora-pbc]

💎 $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