Stream: cds hooks
Topic: versioning of services
Kevin Olbrich (Jan 29 2018 at 20:28):
@Kevin Shekleton have you had any discussions around how to version the cds-service definition itself? I think there are at least two versions that matter.. the version of the service itself, and the version of the cds-hooks standard it's compliant with.
Kevin Shekleton (Jan 29 2018 at 20:29):
@Kevin Olbrich - Yes, we discussed this on a previous Github Issue. I'll dig that issue up, but I think that if you want to version a CDS Service, you should put that new version on a different endpoint/URI (thus, a different CDS Service).
Kevin Olbrich (Jan 29 2018 at 20:30):
That might be fine. What about the hook definition itself?
Kevin Shekleton (Jan 29 2018 at 20:31):
Can you elaborate on how you may want to version the hook definition?
Kevin Shekleton (Jan 29 2018 at 20:31):
To me, the hook definition == the CDS Service
Kevin Shekleton (Jan 29 2018 at 20:31):
I guess you could specify additional prefetch templates over time
Kevin Shekleton (Jan 29 2018 at 20:31):
Or change the description
Kevin Olbrich (Jan 29 2018 at 20:32):
say in v1.0 the context that comes along when invoking a particular hook is different than that defined in v2.0 of cds-hooks.
Kevin Shekleton (Jan 29 2018 at 20:33):
Just so I'm clear, are you talking about versioning the data coming back in the Discovery endpoint?
Kevin Shekleton (Jan 29 2018 at 20:33):
Wait, no
Kevin Shekleton (Jan 29 2018 at 20:33):
I misread your above question
Kevin Olbrich (Jan 29 2018 at 20:33):
partly, and partly about https://cds-hooks.org/hooks/#hook-definition-format
Kevin Shekleton (Jan 29 2018 at 20:34):
Yes, we hook versioning has come up! Alex logged an issue about this Sunday at the end of the Connectathon: https://github.com/cds-hooks/docs/issues/154
Kevin Shekleton (Jan 29 2018 at 20:34):
Feel free to put your thoughts regarding it there.
Kevin Shekleton (Jan 29 2018 at 20:34):
Sorry, I was thinking about versioning of Discovery data
Kevin Olbrich (Jan 29 2018 at 20:35):
I asked about that too.
Kevin Shekleton (Jan 29 2018 at 20:44):
Here is the issue (#74)where we discussed CDS Service versioning
Kevin Shekleton (Jan 29 2018 at 20:45):
Though it looks like 74 was later modified to be about hooks versioning too :-)
Kevin Shekleton (Jan 29 2018 at 20:45):
Or rather, the question became broader about how we would handle the version of the CDS Hooks specification itself :-)
Kevin Olbrich (Jan 29 2018 at 20:45):
I should have known Brian did that.
Kevin Shekleton (Jan 29 2018 at 20:45):
It's turtles (or versions) all the way down :-)
Last updated: Apr 12 2022 at 19:14 UTC
