[GH-ISSUE #937] API is never defined #5700

Closed
opened 2026-06-15 12:13:46 -05:00 by GiteaMirror · 2 comments
Owner

Originally created by @TedTschopp on GitHub (Apr 12, 2023).
Original GitHub issue: https://github.com/semver/semver/issues/937

This requirements document does not define what an API is. With the level of specificity found on the website with regards to this definition, this is a big mix.

For example: Is the UI/UX covered under API. So if I change the complete user flow and the colors and the screens, but none of that is available on an API that is remotely available, does this mean that the API hasn't changed?

Originally created by @TedTschopp on GitHub (Apr 12, 2023). Original GitHub issue: https://github.com/semver/semver/issues/937 This requirements document does not define what an API is. With the level of specificity found on the website with regards to this definition, this is a big mix. For example: Is the UI/UX covered under API. So if I change the complete user flow and the colors and the screens, but none of that is available on an API that is remotely available, does this mean that the API hasn't changed?
Author
Owner

@ljharb commented on GitHub (Apr 13, 2023):

You define the API for your own project.

However, semver is typically used for projects that are consumed programmatically, which means that if there's a UI/UX at all (ie, something that renders, like an app, as opposed to something like a component that gets rendered), semver might not be appropriate.

<!-- gh-comment-id:1506340523 --> @ljharb commented on GitHub (Apr 13, 2023): You define the API for your own project. However, semver is typically used for projects that are consumed programmatically, which means that if there's a UI/UX at all (ie, something that renders, like an app, as opposed to something like a component that *gets* rendered), semver might not be appropriate.
Author
Owner

@steveklabnik commented on GitHub (Apr 13, 2023):

That is 100% correct, @ljharb . Thanks!

<!-- gh-comment-id:1507347588 --> @steveklabnik commented on GitHub (Apr 13, 2023): That is 100% correct, @ljharb . Thanks!
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/semver#5700