Overlays Meeting (2025-01-14)

[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 is the new meetings platform, so don't be alarmed if it looks a little different to previous meetings)

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.

[lornajane]

The new meeting platform worked well!

A quick summary from my (probably patchy) notes - chime in if I missed anything we should mention.

We have some ideas of what might be useful to add next to the specification, we talked about:

• adding a way to test if something is true before doing an operation (related to Example showing setting default response #17 )
• supporting environment variables (already under discussion in Environment Variables in definition #33 )
• making more friendly ways to identify elements to apply actions to

We discussed the new tool from Speakeasy: https://overlays.speakeasy.com and their common use cases which are to sort out operation IDs and naming, add missing error responses, and also to add metadata for their SDK generation tools which benefit from having type hints and other information.

As a group, we know we need to see more users and uses of Overlays and get more feedback before we prioritise the next set of work. We agreed to proactively share our Overlays stories on other platforms and to put into the channel links to places we see the project used!