Skip to content

Commit e6f00dc

Browse files
electron271anemoijereja-eden
authored andcommitted
feat(versioning): add initial versioning documentation with auto-generated examples
1 parent 4426b1a commit e6f00dc

File tree

1 file changed

+32
-0
lines changed

1 file changed

+32
-0
lines changed

VERSIONING.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
# Versioning
2+
3+
## Auto Generated Version Examples
4+
If branch is not main and there are commits since last tag:
5+
```
6+
tux 0.0.0.dev2106+b731156.dynamicversioning
7+
^ ^ ^ ^ ^
8+
name^ commits commit branch (escaped), is empty if its main
9+
ver since hash
10+
last
11+
tag
12+
```
13+
If branch is main and there are commits since last tag:
14+
```
15+
tux 0.0.0.dev2106+b731156
16+
^ ^ ^ ^
17+
name^ commits commit
18+
ver since hash
19+
last
20+
tag
21+
```
22+
If branch is main and there are no commits since last tag:
23+
```
24+
tux 0.0.0
25+
^ ^
26+
name^
27+
ver
28+
```
29+
30+
## Scheme
31+
We use PEP 440 for formatting our version numbers, however we use SemVer for the versioning scheme.
32+
> Keep in mind you cannot use .dev(NUMBER) as it clashes with the auto generated versioning.

0 commit comments

Comments
 (0)