Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

LG 4-4 API versioning #32

Closed
gernotstarke opened this issue Dec 17, 2024 · 4 comments · Fixed by #34
Closed

LG 4-4 API versioning #32

gernotstarke opened this issue Dec 17, 2024 · 4 comments · Fixed by #34
Assignees

Comments

@gernotstarke
Copy link
Member

This is just one of the LG's where I expect more content: Instead of just giving the "headline" (versioning),
you could at least name a few options:

  • versioning by naming (service-v1, service-v2)
  • versioning by metadata, by adding headers, by including the version info in the content (aka body)

What about the relation between versioning and compatibility? Backward-, Forward-?

(there are other LG's with similar issues...)

@dret
Copy link
Contributor

dret commented Dec 17, 2024

This is more of a "philosophical" issue. In my understanding the mission is to keep the curriculum short and not list too may details for the individual learning goals. But you're certainly right that here (and in pretty much every other place) we could go deeper and add details. Before adding these details here I'd like to have a general discussion around the "depth" so that we keep the curriculum at the right level. @StefanZoerner and @programming-wolf, as our shepherds so far, can you please chime in? Thanks a lot!

@gernotstarke
Copy link
Member Author

right, difficult to decide where to add details. imho in versioning at least a few more details would give a decent level of constraint for their trainings...

@dret
Copy link
Contributor

dret commented Dec 18, 2024

I understand. Let's see what @StefanZoerner and @programming-wolf are recommending. For now I'll add the specifics you mentioned for this issue because these definitely should be in there.

dret added a commit that referenced this issue Dec 18, 2024
@dret dret linked a pull request Dec 18, 2024 that will close this issue
@dret
Copy link
Contributor

dret commented Dec 18, 2024

If the general feedback is to make many/all LGs more specific, let's open a separate issue to track things over there. Thanks.

sippsack added a commit that referenced this issue Jan 14, 2025
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 a pull request may close this issue.

4 participants