OAI / OAI/community

Looking for a community driven GH home for unofficial OpenAPI projects

Open
#15 0 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
No language data
Stars
16
Forks
12
PR merge metrics
No merged PRs in 30d

Description

Discussed in https://github.com/OAI/OpenAPI-Specification/discussions/2504

Originally posted by @displague March 18, 2021; migrating to community repo as it is not a spec topic.

I'm looking for a home for an OpenAPI project that has many users, stars, and GH forks but has not seen active maintainership recently and has no system of governance.

While the OAS spec advances, many tools that users have come to depend on are left in less than ideal states. There may be competing interests for each of these projects to adapt to the latest standards or continue to support their implementation discrepancies. The user and developer community behind these projects should have some say in this and largely do. Each of these projects takes on or shirks responsibility whenever OAS changes are introduced. A common body of similarly concerned projects could benefit from each other based on similar languages, users, developers, or ideas.

It is understandable that the OAI organization does not want to show favoritism to any single implementation and should want to avoid the situation where an implementation discrepancy with the spec becomes authoritative.

Many of the OAS tools available today are associated with commercial organizations:

Are these or similar organizations open to adopting existing projects? Would they be able to provide a fair community view that fosters project independence, growth, and health?

Some community-run GH orgs actively maintain community projects or registries:

These orgs may not be open to adopting competing projects or engineering heavy projects.

1. Does @OAI have recommendations for projects looking for community governance and maintainership?

2. Does @OAI have recommendations for community-led initiatives to provide this function?


Authors that have expressed interest in having their tools moved to a central org:

Orgs that have expressed interest in hosting disparate projects and hosting community and governance:

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the linked OAI/OpenAPI-Specification discussion and review the community organizations and potential hosted projects listed in the issue. Done would require an agreed recommendation for community governance or a concrete path for creating or adopting a shared home, rather than an open-ended list of possibilities.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi
Domain
tooling
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.