STAC versions and deprecated components #1142
Replies: 3 comments 8 replies
-
@cholmes could you setup stac-api-spec with Discussions? |
Beta Was this translation helpful? Give feedback.
-
That is true about semantic versioning, but STAC API is not yet 1.0 -- it is still in beta, so the breaking change rule does not yet apply. |
Beta Was this translation helpful? Give feedback.
-
I agree with many of the points you make. I think we're going to be conservative about when Query actually gets removed. With all of the uncertainty about CQL, it might be a good idea to have more precise language about their relationship, rather than simply saying Query is deprecated. I think when I first started Filter Extension last month, we thought it was more "done" and that we'd simply be connecting STAC API and CQL -- but now it seems there's a lot of uncertainty about how CQL will evolve, and we need to wait for that before Filter can be done (or even usable between tools). |
Beta Was this translation helpful? Give feedback.
-
👋 we talked about this in the last call and I though that this channel would be a good way to continue, although the case we raised is related to stac-api and not stac-spec.
At some point we discussed which version would remove the deprecated Query extension. It is my understanding that the removal is a breaking change, and following semantic versioning guidelines it will not be removed in 1.x but only in >= 2.x
That means, in practice, that Query will be around for many years.
Filter extension greatly extend the search capabilities but there are some concerns on implementation effort and used standards (CQL-JSON is new, etc).
So developers will be faced with two choices when adding basic filter API extension (basic = Query):
That is a very hard choice for people not familiarized with the discussions. For my particular use case I think that Query would be my choice even if I had to work on a new implementation. This conflicts with the idea that it is not very smart to start an implementation with an already deprecated component.
Maybe we should mark Query as deprecated when Filter is more stable and have some implementations? A possible scenario is Query being deprecated at some 1.x (x>0) version and removed in 2.0.
CC @philvarner
Beta Was this translation helpful? Give feedback.
All reactions