docs: update OpenAPI generation docs

[pepopowitz]

Description

Describes the features added to API doc generation in #4799. (Basically, the ability to generate numbered versions of API docs.)

When should this change go live?

• This is a bug fix, security concern, or something that needs urgent release support. (add bug or support label)
• This is already available but undocumented and should be released within a week. (add available & undocumented label)
• This is on a specific schedule and the assignee will coordinate a release with the DevEx team. (create draft PR and/or add hold label)
• This is part of a scheduled alpha or minor. (add alpha or minor label)
• There is no urgency with this change (add low prio label)

PR Checklist

• My changes are for the next minor and are in /docs directory (aka /next/).
• My changes are for an already released minor and are in /versioned_docs directory.

• I added a DRI, team, or delegate as a reviewer for technical accuracy and grammar/style:

  • Engineering team review
  • Technical writer review via @camunda/tech-writers unless working with an embedded writer.

• My changes require a docs infrastructure review. (add dx label)