Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Remove SIG details; instead link to community/SPECIAL_INTEREST_GROUPS #3948

Merged
merged 1 commit into from
Jul 11, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
77 changes: 2 additions & 75 deletions SPECIAL_INTEREST_GROUPS.md
Original file line number Diff line number Diff line change
@@ -1,78 +1,5 @@
# OpenAPI Special Interest Groups (SIGs)

OpenAPI Special Interest Groups, or "SIGs", are the OpenAPI Initiative's way of focusing work in particular areas. SIGs may start with just a Slack channel to guage interest. SIGs with enough traction to produce work may have their own GitHub repositories and regular Zoom calls, and ultimately produce work that becomes part of, or a companion to, the OpenAPI Specification.

## Codegen

Code Generation JSON Schema vocabulary special interest (working) group

* [Slack](https://communityinviter.com/apps/open-api/openapi) channel: #sig-codegen

## Finance

Focusing on finance topics such as Open Banking / Open Finance

* [Slack](https://communityinviter.com/apps/open-api/openapi) channel: #sig-finance

## Formats

Focusing on the [Formats Registry](https://spec.openapis.org/registry/format/) efforts.

* [Slack](https://communityinviter.com/apps/open-api/openapi) channel: #sig-formats
* Work Items: [Open Issues](https://github.com/OAI/OpenAPI-Specification/issues?q=is%3Aissue+is%3Aopen+label%3Aformat-registry), [Open PRs](https://github.com/OAI/OpenAPI-Specification/pulls?q=is%3Apr+is%3Aopen+label%3Aformat-registry)

## Industry Standards

Focusing on how industry standards groups make use of OpenAPI specifications.

* [Slack](https://communityinviter.com/apps/open-api/openapi) channel: #sig-industry-standards

## Lifecycle

A place to discuss how to represent how APIs change in time in the context of OpenAPI.

* [Slack](https://communityinviter.com/apps/open-api/openapi) channel: #sig-lifecycle

## Moonwalk

Working group for the next major (post-3.x) version of the OpenAPI Specification

* GitHub: [OAI/sig-moonwalk](https://github.com/OAI/sig-moonwalk)
* Zoom Meetings: Tuesdays at 9AM US-Pacific

## Overlays

The Overlay specification defines a way of creating documents that contain information to be merged with an OpenAPI description at some later point in time, for the purpose of updating the OpenAPI description with additional information.

* GitHub: [OAI/Overlay-Specification](https://github.com/OAI/Overlay-Specification)
* [Slack](https://communityinviter.com/apps/open-api/openapi) channel: #sig-overlays

## Security

Workgroup to shape security components of the OpenAPI Specification.

* [Slack](https://communityinviter.com/apps/open-api/openapi) channel: #sig-security

## SLA (Service Level Agreement)

Service level agreements and APIs.

* GitHub: [isa-group/SLA4OAI-TC](https://github.com/isa-group/SLA4OAI-TC)
* [Slack](https://communityinviter.com/apps/open-api/openapi) channel: #sig-sla

## Travel

An OpenAPI Initiative workgroup to address industry specific connective/API concerns of the travel industry.

* [Slack](https://communityinviter.com/apps/open-api/openapi) channel: #sig-travel

## Workflows

The OpenAPI Specification provides a way to document individual API calls and how to use them, but it doesn't give insight into the common ways to sequence those operations. While all APIs can benefit from formally describing these workflows, this is particularly important when considering more complex or more secure APIs.

The OpenAPI Workflows Special Interest Group was created to address this common problem. The goal is to construct a formal way to describe these sequences and support documentation of flows, such as a multi-part OAuth flow with JSON signing and refresh token behavior.

* GitHub: [OAI/sig-workflows](https://github.com/OAI/sig-workflows)
* [Slack](https://communityinviter.com/apps/open-api/openapi) channel: #sig-workflows
* Zoom Meetings: Wednesdays at 9AM US-Pacific
OpenAPI Special Interest Groups, or "SIGs", are the OpenAPI Initiative's way of focusing work in particular areas. SIGs may start with just a Slack channel to gauge interest. SIGs with enough traction to produce work may have their own GitHub repositories and regular Zoom calls, and ultimately produce work that becomes part of, or a companion to, the OpenAPI Specification.

See the [OAS community repository](https://github.com/OAI/community/blob/main/SPECIAL_INTEREST_GROUPS.md) for a complete list of SIGs, and for more information about forming a SIG.