This is a repo for moving forward a variety of projects within the OpenAPI community. In an effort to be more transparent and help involve the community in a variety of ways we will be managing most projects within this repository. This README should provide you with everything you need to get started working on an existing project, or suggest a new project.
We are just getting started with this effort to external project work, so this process will evolve. Here are the moving parts for managing projects using this repository:
- README - The README is the "home page" for all the project being managed and will be kept as an overview of everything that is happening.
- Issues - We are using issues for the catch all basket for any comments, questions, or feedback, and projects can have multiple issues.
- Projects - Once an idea or suggestion for a new project is set into motion it will be given a formal project for managing all tasks.
- Pages - Ongoing projects may also have a dedicated markdown page that provides access to any related documents and artifacts.
- Folder - Projects may also be able to have their own folders within the repository for organizing any code or related artifacts.
Feel free to suggest a new project by submitting an issue, or roll up your sleeves and get involved in a specific project by jumping in on the issues or the discussions for each area of work.
These are the projects currently being moved forward in some capacity. Each project has a listing of to do, in progress, and done tasks, as well as link to any open issues or discussions.
- Member Showcase & Engagement - Continually improving our showcasing and engagement with our members while actively working to recruit new ones.
- Profile & Engage with API Providers - Work to identify, profile, and build relationships with API providers who have implemented the OpenAPI specification.
- Profile and Engage with Open Source Tooling - Establish an official directory of open source tooling that uses OAS, and actively work to establish and build relationships with them.
- Business Sector Showcase & Engagement - Work to profile different business sectors that are putting OpenAPI to work, then engage, and build relationships with individuals or organizations.
- Quantify the Scope of the OpenAPI Community - Work to establish the size and scope of the OpenAPI community and then track on the growth over time.
- Curate and Publish API Videos - Work to discover, curate, and then showcase the existing videos that exist about OpenAPI.
- OpenAPI Search Engine Optimization - This is ongoing work to help improve the search engine optimization for the OAI and OAS, helping increase it's presence.
- Additional OAI Leadership - Work to define the roles for 3 additional leadership within the OAI, and help them be successful in work over a year.
- Strengthen Multi-Specification Relationships - Ongoing work to help strengthen the relationships between the OAI and other API specifications like AsyncAPI, GraphQL, JSON Schema, and gRPC.
- JSON Schema Documentation Update - This is work to invest in the updating of JSON Schema documentation, helping invest in supporting specifications.
- OpenAPI Initiative Incubator Project Proposal Process - This is a ongoing project ot help move forward the process that governs any incubator project added to the OpenAPI Initiative (OAI).
- Workflow and Automation Incubator Project - This is a project to manage the workflow and automation incubator project proposal and effort once it is accepted by the TOB.
- Security Incubator Project - This is a project to manage the security incubator project proposal and effort once it is accepted by the TOB.
- SLA Incubator Project - This is a project to manage the security incubator project proposal and effort once it is accepted by the TOB.
- Travel Journey Incubator Project - This is a project to manage the airline, hospitality, rail, and travel incubator project proposal and effort once it is accepted by the TOB.
As projects are complete they will be closed, with some projects living on forever and issues and discussions being used to drive ongoing work.
These are the individuals who are currently part of moving projects forward as part of the OAI, and here to answer any questions.
- Isabelle Mauny - Representing as co-chair of the BGB Board.
- Kin Lane - Representing as co-chair of the BGB Board.
If you'd like to be added please submit a Github issue stating how you'd like to help and we'll add you to the list of participants.