mirror of
https://codeberg.org/forgejo/docs.git
synced 2024-11-30 19:03:43 -05:00
04488991b1
- Format according to prettier. Co-authored-by: Gusted <postmaster@gusted.xyz> Reviewed-on: https://codeberg.org/forgejo/website/pulls/196 Reviewed-by: Loïc Dachary <dachary@noreply.codeberg.org> # Conflicts: # v1.19/index.md # v1.19/user/project.md # v1.19/user/protection.md # v1.19/user/wiki.md # v1.20/admin/config-cheat-sheet.md # v1.20/admin/database-preparation.md # v1.20/developer/code-forgejo-org.md # v1.20/license.md # v1.20/user/api-usage.md # v1.20/user/authentication.md # v1.20/user/email-settings.md # v1.20/user/issue-pull-request-templates.md # v1.20/user/oauth2-provider.md # v1.20/user/packages/index.md # v1.20/user/packages/maven.md # v1.20/user/semver.md
46 lines
1.8 KiB
Markdown
46 lines
1.8 KiB
Markdown
---
|
|
layout: '~/layouts/Markdown.astro'
|
|
title: Semantic version
|
|
license: 'CC-BY-SA-4.0'
|
|
---
|
|
|
|
[SemVer](https://semver.org/spec/v2.0.0.html) allows users to understand the scope of a software update at first glance, based on the following :
|
|
|
|
- Patch is increased for backwards-compatible bugfixes.
|
|
- Minor is increased for backwards-compatible new features.
|
|
- Major is increased for breaking changes.
|
|
|
|
_something_ could be :
|
|
|
|
- a command, an option or an argument, for a CLI ;
|
|
- a route path, a query parameter or a body property, for a REST API ;
|
|
- a text node, a button or a field, for a GUI.
|
|
|
|
Since Forgejo has all of the above, changes to all of those components should be taken into consideration when creating a new version number.
|
|
|
|
## Getting the Forgejo semantic version
|
|
|
|
As of Forgejo v1.19, there are two version numbering schemes:
|
|
|
|
- [Following the Gitea version](https://codeberg.org/forgejo/forgejo/src/branch/forgejo/CONTRIBUTING/RELEASE.md#release-numbering) which is not a semantic version
|
|
- Used to name release files
|
|
- Used for tagging releases
|
|
- Displayed in the web interface
|
|
- Returned by the `/api/v1/version` API endpoint
|
|
- Forgejo semantic version
|
|
- Returned by the `/api/forgejo/v1/version` API endpoint
|
|
|
|
For instance, the semantic version for https://code.forgejo.org can be obtained with:
|
|
|
|
```shell
|
|
$ curl https://code.forgejo.org/api/forgejo/v1/version
|
|
{"version":"3.0.0+0-gitea-1.19.0"}
|
|
```
|
|
|
|
## Understanding the Forgejo semantic version
|
|
|
|
The structure of the version number is `<major>.<minor>.<patch>+<build>-gitea-<gitea version>` where:
|
|
|
|
- `<major>.<minor>.<patch>` is conformant to [Semantic Versioning 2.0.0](https://semver.org/#semantic-versioning-200)
|
|
- `<build>` is the release build number of an otherwise identical source
|
|
- `gitea-<gitea version>` is the Gitea version this Forgejo release depends on
|