feat(openapi-typescript): add jsdoc comments to response object

[backflip]

Changes

This PR adds JSDoc comments like @example to response objects. We are missing them in our generated types. They are already present on request objects and in many other places.

How to Review

See changes in examples/digital-ocean-api.ts below.

Checklist

• Unit tests updated
• docs/ updated (if necessary)
• pnpm run update:examples run (only applicable for openapi-typescript)

[netlify]

👷 Deploy request for openapi-ts accepted.

Name	Link
🔨 Latest commit	9373151
🔍 Latest deploy log	https://app.netlify.com/projects/openapi-ts/deploys/67f65b3fdd5fd7000826db75

[changeset-bot]

⚠️ No Changeset found

Latest commit: 9373151

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[gzm0]

TY very much for the contribution.

Review note: I have verified that the added examples appear verbatim in the original OpenAPI (and are not generated). As such, I am not worried about code bloat or duplicated examples. It is up to the OpenAPI author to decide at which level to add examples (object or object field, etc.).

[gzm0]

Dang... We should have included a changeset here :(