Skip to content

Let's define together what we understand by "critical" JSON Schema projects #521

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

Open
benjagm opened this issue Nov 6, 2023 · 11 comments
Open
Assignees
Labels
✨ Enhancement Indicates that the issue suggests an improvement or new feature. Status: Do not close This is a long term issue with dependant issues. This label prevent it to be closed automatically. Status: In Progress This issue is being worked on, and has someone assigned.

Comments

@benjagm
Copy link
Collaborator

benjagm commented Nov 6, 2023

Objective

This issue aims to start a discussion to define together what we understand by "critical" JSON Schema projects and establish the eligibility criteria and the support provided for these projects. Currently taking advantage of and supporting projects Bowtie that are not part of the Github Organization but are critical for the whole JSON Schema Ecosystem and this issue aims to standarize this situation by find a common definition, eligibility criteria and the benefits.

Defining Critical Projects (My proposal)

To qualify as a "critical" project, a JSON Schema project should meet the following criteria:

  • Language Agnostic: The project should be language-agnostic, ensuring its relevance to a wide range of developers working with JSON Schema, regardless of the programming language they are using.

  • Uniqueness: The project should offer unique and valuable functionality, avoiding direct competition with existing tools in the JSON Schema ecosystem. It should fill a gap or provide an innovative solution to a problem not adequately addressed by other projects.

  • Impact: Critical projects should have a significant and positive impact on the entire JSON Schema ecosystem, benefiting a large user base, or addressing key challenges faced by the community.

  • Open Source: Critical projects should be Open Source by definition.

Support for Critical Projects (My proposal)

The support provided to critical projects will include:

  • Participation in Mentoring and Contribution Programs: Critical projects will be eligible for mentorship programs to help onboard new contributors, and they will have access to resources and guidance to foster their growth.

  • Promotion of New Features and Updates: We will actively assist critical projects in promoting new features and updates to ensure they reach a wider audience, including cross-promotion within the JSON Schema community and on relevant platforms.

Process to join the List (To be defined)

For a project to get this status there should be a TSC voting process.

Projects to consider:

Projects lists

As soon as we have consensus on definition, benefits, accessibility and the projects part of this list we'll make the list available similarly to adopters.md.

Help us to define this together

We value your input and invite you to participate in this discussion. Please provide your feedback, suggestions, and nominations for projects that you believe meet the criteria for critical JSON Schema projects.

@benjagm
Copy link
Collaborator Author

benjagm commented Nov 6, 2023

@Relequestual @Julian @jviotti I'd love to get your thoughts here.

@jviotti
Copy link
Member

jviotti commented Nov 6, 2023

Makes sense! I'd object on my own Alterschema project based on those requirements though. The library behind Alterschema will be programming language specific, but I guess we can always maintain a language agnostic web UI around it. Would that be acceptable?

@Julian
Copy link
Member

Julian commented Nov 6, 2023

Alterschema is available as a CLI though no? And that's presumably the primary way people would use it at the minute? Or do you expect they use it as a library?

Because if it's the former, which would be my guess, then I think it's fine -- every tool of course is written in some language, Bowtie included -- but it's usable from any via the CLI. Of course if you use it in the host language maybe you get extra stuff (e.g. calling Bowtie from Python or whatever maybe is easier), but the spirit of language-agnostic is certainly there.

@benjagm
Copy link
Collaborator Author

benjagm commented Nov 6, 2023

language agnostic web UI

In the issue I just provided an initial proposal to start the discussions. Regarding providing a web UI or even a CLI tool for my will be enough.

@jviotti
Copy link
Member

jviotti commented Nov 6, 2023

Yeah, that's what I mean. If we clarify CLI / Web is an acceptable interface, then that sounds good to me, but I think it should be more clearly outlined ^

@Relequestual
Copy link
Member

I'd like to do a trial run of the proposed and mostly approved governance process to try and best find consensus on what the "critical projects" program looks like.

@Relequestual Relequestual self-assigned this Nov 6, 2023
@benjagm benjagm changed the title Defining Critical JSON Schema Projects Let's define together what we understand by "critical" JSON Schema projects Nov 6, 2023
@benjagm
Copy link
Collaborator Author

benjagm commented Nov 6, 2023

find consensus on what the "critical projects" program

My idea with this issue is to find a common definition of things... not to define the program itself. The program should have some strategic goals, KPIs and other elements that to be defined later, once we all have the same view and consensus to proceed.

@benjagm benjagm added 🎯 Roadmap Identify issues related to the project roadmap ✨ Enhancement Indicates that the issue suggests an improvement or new feature. and removed 🎯 Roadmap Identify issues related to the project roadmap labels Nov 22, 2023
@benjagm
Copy link
Collaborator Author

benjagm commented Feb 17, 2024

I don't see much progress. Is it ok If I proceed with a proposal of how this program will look like?

@Relequestual
Copy link
Member

Relequestual commented Apr 4, 2024

I'm now activly working on driving this work.

Copy link

Hello! 👋

This issue has been automatically marked as stale due to inactivity 😴

It will be closed in 180 days if no further activity occurs. To keep it active, please add a comment with more details.

There can be many reasons why a specific issue has no activity. The most probable cause is a lack of time, not a lack of interest.

Let us figure out together how to push this issue forward. Connect with us through our slack channel : https://json-schema.org/slack

Thank you for your patience ❤️

@github-actions github-actions bot added the Status: Stale It's believed that this issue is no longer important to the requestor. label Jun 23, 2024
@benjagm benjagm added Status: In Progress This issue is being worked on, and has someone assigned. Status: Do not close This is a long term issue with dependant issues. This label prevent it to be closed automatically. and removed Status: Stale It's believed that this issue is no longer important to the requestor. labels Jun 23, 2024
@benjagm
Copy link
Collaborator Author

benjagm commented Jun 23, 2024

I am tagging this issue do not close to not be considered by the bot collecting stale issues.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
✨ Enhancement Indicates that the issue suggests an improvement or new feature. Status: Do not close This is a long term issue with dependant issues. This label prevent it to be closed automatically. Status: In Progress This issue is being worked on, and has someone assigned.
Projects
None yet
Development

No branches or pull requests

4 participants