Skip to content

Commit 7aaeaf9

Browse files
authored
Merge pull request #127 from lornajane/community-docs
Add a community page to the documentation
2 parents 9b1c74d + a96dae7 commit 7aaeaf9

File tree

1 file changed

+90
-0
lines changed

1 file changed

+90
-0
lines changed

community.md

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
---
2+
layout: default
3+
title: Community
4+
nav_order: 20
5+
---
6+
7+
# OpenAPI Community
8+
9+
The OpenAPI Initiative is an open group, and we welcome participation in all our activities.
10+
Use this page to find out where you can find resources and how to get more involved with the project.
11+
12+
## Quick Reference
13+
14+
- Main website: <https://www.openapis.org>
15+
- Specification: <https://spec.openapis.org>
16+
- Documentation: <https://learn.openapis.org> (this website)
17+
- GitHub organisation: <https://github.com/OAI/>
18+
19+
## Connect With OpenAPI
20+
21+
Find and follow/chat with us in one of these places:
22+
23+
- [Newsletter](https://www.openapis.org) (scroll down for the signup form) - A low-traffic summary of news from the group.
24+
- [GitHub](https://github.com/OAI) is our organization, you can find all our projects listed there. Use discussions for questions, and feel free to check the issue and pull request lists to see what's in progress.
25+
- [LinkedIn](https://www.linkedin.com/company/open-api-initiative/) is another good way to get updates on our news.
26+
- [Slack](https://communityinviter.com/apps/open-api/openapi) for informal chat between project members.
27+
28+
## Membership
29+
30+
Being a member of OpenAPI Initiative gives your organization a voice within the project, as well as supporting our activities.
31+
32+
- [View the list of members](https://www.openapis.org/membership/members)
33+
- [Learn more about membership](https://www.openapis.org/membership/join)
34+
35+
## Participate in Working Groups
36+
37+
OpenAPI Initiative publishes more than one specification, each with its own repository and community.
38+
39+
### OpenAPI Specification
40+
41+
The main OpenAPI Specification project provides a human- and machine-readable format for describing HTTP APIs.
42+
43+
- **Published resources:** [Specification](https://spec.openapis.org/#openapi-specification)
44+
| [Documentation](https://learn.openapis.org/)
45+
| [JSON Schema](https://spec.openapis.org/#openapi-specification-schemas)
46+
| [Registries](https://spec.openapis.org/registry/index.html)
47+
48+
- **On GitHub:** [ReadMe](https://github.com/OAI/OpenAPI-Specification/?tab=readme-ov-file#readme)
49+
| [Discuss OpenAPI (questions welcome)](https://github.com/OAI/OpenAPI-Specification/discussions)
50+
| [Read release notes](https://github.com/OAI/OpenAPI-Specification/releases)
51+
| [Review active pull requests](https://github.com/OAI/OpenAPI-Specification/pulls)
52+
| [Issues list](https://github.com/OAI/OpenAPI-Specification/issues)
53+
54+
- **Weekly Technical Meetings:** [Meetings list](https://github.com/OAI/OpenAPI-Specification/issues?q=is%3Aissue%20state%3Aopen%20%22Open%20Community%22) - The joining instructions are in the agenda for the meeting.
55+
56+
- **On Slack:** `#spec` channel
57+
58+
### Arazzo Specification
59+
60+
Arazzo Specification describes a sequence of API calls and how data flows between multiple endpoints.
61+
62+
- **Published resources:** [Specification](https://spec.openapis.org/#arazzo-specification)
63+
| [JSON Schema](https://spec.openapis.org/#arazzo-schemas)
64+
65+
- **On GitHub:** [ReadMe](https://github.com/OAI/Arazzo-Specification/?tab=readme-ov-file#readme)
66+
| [Discuss OpenAPI (questions welcome)](https://github.com/OAI/Arazzo-Specification/discussions)
67+
| [Read release notes](https://github.com/OAI/Arazzo-Specification/releases)
68+
| [Review active pull requests](https://github.com/OAI/Arazzo-Specification/pulls)
69+
| [Issues list](https://github.com/OAI/Arazzo-Specification/issues)
70+
71+
- **Technical Meetings:** [Meetings list](https://github.com/OAI/Arazzo-Specification/issues?q=is%3Aissue%20state%3Aopen%20%22Meeting%22) - The joining instructions are in the agenda for the meeting.
72+
73+
- **On Slack:** `#arazzo` channel
74+
75+
### Overlay Specification
76+
77+
- **Published resources:** [Specification](https://spec.openapis.org/#overlay-specification)
78+
| [Documentation](https://learn.openapis.org/overlay/)
79+
| [JSON Schema](https://spec.openapis.org/#overlay-specification-schemas)
80+
81+
- **On GitHub:** [ReadMe](https://github.com/OAI/Overlay-Specification/?tab=readme-ov-file#readme)
82+
| [Discuss OpenAPI (questions welcome)](https://github.com/OAI/Overlay-Specification/discussions)
83+
| [Read release notes](https://github.com/OAI/Overlay-Specification/releases)
84+
| [Review active pull requests](https://github.com/OAI/Overlay-Specification/pulls)
85+
| [Issues list](https://github.com/OAI/Overlay-Specification/issues)
86+
87+
- **Technical Meetings:** [Meetings list](https://github.com/OAI/Overlay-Specification/discussions/categories/meeting-notes) - The joining instructions are in the agenda for the meeting.
88+
89+
- **On Slack:** `#overlays` channel
90+

0 commit comments

Comments
 (0)