Changes in the contributing guidelines to improve onboarding #31
Conversation
CONTRIBUTING.md
Outdated
| * [JSON Schema Conference](https://github.com/json-schema-org/conference/blob/main/CONTRIBUTING.md). | ||
| * [Tour of JSON Schema](https://github.com/json-schema-org/tour/blob/main/CONTRIBUTING.md). | ||
| * [JSON Schema Landscape](https://github.com/json-schema-org/landscape/blob/main/CONTRIBUTING.md). | ||
| * [JSON Schema Ecosystem](https://github.com/json-schema-org/ecosystem). |
There was a problem hiding this comment.
The link for JSON Schema Ecosystem should follow the format for the other projects i.e referencing the contributing.md file "https://github.com/json-schema-org/landscape/blob/main/CONTRIBUTING.md" OR if there's a reason why we are referencing "https://github.com/json-schema-org/ecosystem", then this implementation is okay.
CONTRIBUTING.md
Outdated
| * [JSON Schema Ecosystem](https://github.com/json-schema-org/ecosystem). | ||
|
|
||
| * 🌐 Other JSON Schema Ecosystem Projects you can contribute to: | ||
| * [Bowtie](https://github.com/bowtie-json-schema/bowtie) development |
There was a problem hiding this comment.
Why are we calling out bowtie specifically but only referring to (and also not linking to) "other tools"?
There was a problem hiding this comment.
Why are we calling out bowtie specifically but only referring to (and also not linking to) "other tools"?
That is a great question. I have been pushing for a standard agreement about reaching a common understanding of what means "critical JSON Schema projects" and what those are, but the issue with that discussion is still ongoing json-schema-org/TSC#5. Happy to add here other critical projects like alterschema.
In terms of implementations, that is a different story because, as of now, we have been neutral, avoiding promoting certain implementations over others. However, we could create a way for implementers to communicate that they seek new contributors by adding a new field to the tooling metadata.
|
Due to the current direction to contributing guidelines for aspiring gsoc participants, can we have this pr merged if there is nothing else blocking it? |
This PR includes some changes in the global contributing guidelines to improve the onboarding of new users.
Related json-schema-org/community#849