Skip to content

Add versioning #42

Open
martinbonnin wants to merge 6 commits intomainfrom
structure
Open

Add versioning #42
martinbonnin wants to merge 6 commits intomainfrom
structure

Conversation

@martinbonnin
Copy link
Contributor

@martinbonnin martinbonnin commented Dec 23, 2025

Follow up from #39

This introduces versioning to makes it easier to see the latest version of a scalar at a glance. The main index could filter out the outdated versions of scalars.

See also graphql/graphql-wg#1879

@glen-84
Copy link
Contributor

glen-84 commented Dec 24, 2025

On 2nd thought, perhaps we should wait for the first need for versioning, as opposed to implementing this now. It may not be something that happens often, if at all.

martinbonnin and others added 3 commits December 24, 2025 19:50
@martinbonnin
Copy link
Contributor Author

we should wait for the first need for versioning, as opposed to implementing this now. It may not be something that happens often, if at all.

I'd like to push for versioning because it removes friction. It's easy to release v0.1. Releasing v1.0 feels a lot harder.

@martinbonnin martinbonnin changed the title Add versioning and graphql namespace Add versioning Dec 30, 2025
@martinbonnin
Copy link
Contributor Author

I've updated the description of this PR to make it only about versionning as it's a separate thing. See #54 for the graphql namespace.

@glen-84
Copy link
Contributor

glen-84 commented Dec 30, 2025

I'm not following how versioning would make the current index easier to read. The specs should probably just be grouped by author.

@martinbonnin
Copy link
Contributor Author

martinbonnin commented Dec 30, 2025

@glen-84 you're right, it's a separate concern, I've updated the description. My reasonning is that I don't want to change the index.html too often. I'd rather do everything all at once: versionning + grouping.

Edit: PR for grouping is there: #55

@martinbonnin
Copy link
Contributor Author

martinbonnin commented Jan 15, 2026

Quick notes from the January Working Group:

@leebyron mentions we already have a graphql namespace, it's the spec, no real need for it.
@benjie says we can do collaborative upvoting. If one scalar is well regarded, other can link to it.
@michaelstaib says we could promote the scalars in the main spec.

@michaelstaib also mentioned we could merge the scalars with the contrib repo

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants