Overlays Meeting (2025-11-18)

[github-actions[bot]]

This discussion is about a meeting of the OpenAPI Overlays group.
We meet on alternate Tuesdays at 08:00 Pacific time, and this is a public meeting.

Meeting link: https://zoom-lfx.platform.linuxfoundation.org/meeting/99628896838?password=f3ff9796-d6a0-4749-b39e-93dc7eafe7cd

This meeting is covered by the OpenAPI Initiative Code of Conduct.

Add comments to this discussion to add items to the agenda for the meeting.

[smikulcik]

I missed the last call (got times confused), but I do plan to make this next one to talk about this.

I want to publish overlays+openapi to our API consumers to describe the changeset as the well defined scope of the features we deliver.

While I recognize that there are some challenges to enable consumers to interpret this data (openapi+overlays), I do believe that we can solve these by providing better tools and conventions.

For a topic, I want to hear from the community how we are thinking about these overlay documents in the dialog with spec interactions: Human written vs computed, distributed vs baked-in, etc.

I'm also feeling out the tooling appetite for feature centric overlays - is this contrary to any of our mission/purpose statements? While it seems natural to me, I understand there's some hesitation with connecting the dots from spec to overlays.

[baywet]

I think a reading that will be relevant to this topic is this one OAI/OpenAPI-Specification#5120

[baywet]

Adding:

• feat: adds description field to overlay info object #233
• feat: adds a parameter object for the action object #238