python-jsonschema / check-jsonschema

A CLI and set of pre-commit hooks for jsonschema validation with built-in support for GitHub Workflows, Renovate, Azure Pipelines, and more!
https://check-jsonschema.readthedocs.io/en/stable
Other
191 stars 39 forks source link

bitbucket schema weirdness #440

Closed blade2005 closed 2 weeks ago

blade2005 commented 3 weeks ago

Bitbucket schemas aren't officially released but can be found in repo's that interact with the bitbucket pipeline config file.

The 2 schemas I can find are

In the catalog is the one from atlascode. However it looks like intellij-bitbucket-references-plugin has a newer one that conforms to the documentation from bitbucket's doc site. I'll be honest I don't know which is 'official' or most up to date, but looking at the issues open with each project, I see a faster response on the intellij one for schema updates. However atlascode, looks like it is an official plugin.

In summary intellij gets more updates and faster responses, but is a 3rd party repo; atlascode, is official but I see issues related to out of date schemas open from at least the beginning of the year. I'd suggest switching which url is in catalog to the one from intellij.

sirosen commented 3 weeks ago

Both appear to be maintained under Atlassian Labs, but it's not clear if that designation means that they are in any way official? This is, indeed, pretty weird. Like you say, it looks like one is Atlassian-driven and one is 3rd party. SchemaStore is using the newer one ( https://github.com/SchemaStore/schemastore/pull/3098 ), and I have no particular reason to prefer one source over the other. This situation makes me a little bit uncomfortable.

I think I will take a (new, as of right now) policy stance that until/unless there is some significant reason to diverge, I'll follow SchemaStore's lead on where to source things. That at least sets a rule which I can follow and we'll see where it leads.

blade2005 commented 2 weeks ago

I think that's a good direction of following schemastore's lead.