Add section describing versioning and update policy #347

Merged
pat-s merged 13 commits from update-policy into main 2023-03-08 17:14:34 +00:00
pat-s commented 2022-08-21 07:29:48 +00:00 (Migrated from gitea.com)

After recent discussions in Discord.

Feel free to modify as needed!

After recent discussions in Discord. Feel free to modify as needed!
justusbunsi (Migrated from gitea.com) reviewed 2022-08-21 07:29:59 +00:00
justusbunsi (Migrated from gitea.com) reviewed 2022-08-21 12:23:49 +00:00
justusbunsi (Migrated from gitea.com) commented 2022-08-21 12:25:14 +00:00
- values.yml
+ values.yaml
```diff - values.yml + values.yaml ```
justusbunsi (Migrated from gitea.com) commented 2022-08-21 12:28:36 +00:00

Do we speak of minor version bump or major version bump between 1.13 to 1.14?

I am thinking of the naming for semver major.minor.path but am not sure what's correct in the context of Gitea versioning.

Do we speak of minor version bump or major version bump between 1.13 to 1.14? I am thinking of the naming for semver `major.minor.path` but am not sure what's correct in the context of Gitea versioning.
justusbunsi (Migrated from gitea.com) commented 2022-08-21 14:15:19 +00:00

Gitea doesn't strictly follow semantic versioning as breaking changes do not increase the major version.
So in Gitea's case "minor" version bumps are actually "major". This is why I added the example to make it explicit and explain this case in more detail.

I'd also refer to it as "minor" as this is what is commonly used for the x.y.z logic. But I also see that others might do different. I think we can't discuss Gitea's general versioning approach here :D

How would you (re)phrase it?

Gitea doesn't strictly follow semantic versioning as breaking changes do not increase the major version. So in Gitea's case "minor" version bumps are actually "major". This is why I added the example to make it explicit and explain this case in more detail. I'd also refer to it as "minor" as this is what is commonly used for the x.y.z logic. But I also see that others might do different. I think we can't discuss Gitea's general versioning approach here :D How would you (re)phrase it?
justusbunsi (Migrated from gitea.com) commented 2022-08-21 16:43:17 +00:00

Probably exactly how you explained.

Gitea doesn't strictly follow [semantic versioning](https://semver.org/#summary) as breaking changes do not increase the major version. So in Gitea's case "minor" version bumps are actually "major".

as an addition to the sentence "Note that using the :1 will also...."

Probably exactly how you explained. ``` Gitea doesn't strictly follow [semantic versioning](https://semver.org/#summary) as breaking changes do not increase the major version. So in Gitea's case "minor" version bumps are actually "major". ``` as an addition to the sentence "Note that using the `:1` will also...."
justusbunsi (Migrated from gitea.com) commented 2022-08-21 12:23:49 +00:00

Loose end?

Loose end?
justusbunsi (Migrated from gitea.com) commented 2022-08-21 14:17:04 +00:00

Good catch!

Good catch!
pat-s commented 2022-09-07 06:56:27 +00:00 (Migrated from gitea.com)

blocked by #355

blocked by #355
luhahn (Migrated from gitea.com) reviewed 2022-09-25 20:27:19 +00:00
lunny (Migrated from gitea.com) reviewed 2022-09-25 20:27:28 +00:00
pat-s commented 2023-03-07 22:19:04 +00:00 (Migrated from gitea.com)

@justusbunsi Can we merge here?

@justusbunsi Can we merge here?
techknowlogick (Migrated from gitea.com) reviewed 2023-03-07 22:21:43 +00:00
techknowlogick (Migrated from gitea.com) commented 2023-03-07 22:21:43 +00:00

Can you use dl.gitea.com instead of the .io due to the recent CDN changes?

Can you use dl.gitea.com instead of the .io due to the recent CDN changes?
techknowlogick (Migrated from gitea.com) commented 2023-03-07 22:22:03 +00:00

Can you use considered instead of actually?

Can you use `considered` instead of `actually`?
lunny (Migrated from gitea.com) approved these changes 2023-03-08 15:21:47 +00:00
justusbunsi (Migrated from gitea.com) approved these changes 2023-03-08 15:34:37 +00:00
justusbunsi (Migrated from gitea.com) left a comment

LGTM

LGTM
justusbunsi commented 2023-03-08 15:36:18 +00:00 (Migrated from gitea.com)

@techknowlogick Anything left from your side?

@techknowlogick Anything left from your side?
techknowlogick (Migrated from gitea.com) approved these changes 2023-03-08 17:14:24 +00:00
Sign in to join this conversation.
No description provided.