64 lines
2.3 KiB
Markdown
64 lines
2.3 KiB
Markdown
# jhaas
|
|
|
|
Home-Lab & Hardware-Modding: Elektronik, Embedded-Firmware, Leiterplattenfertigung,
|
|
CAD-Design und 3D-Druck, dazu Astrofotografie, ein selbstgehosteter Homeserver
|
|
und gelegentlich Bierbrauen.
|
|
|
|
Dieses Repo enthält keinen Code — Forgejo rendert sein `README.md` auf der
|
|
Profilseite, daher dient es dazu, Konventionen zu halten, die für alle Repos
|
|
unten gelten, statt sie in jedem einzeln zu duplizieren.
|
|
|
|
## Tech-Stack & Interessen
|
|
|
|
- Elektronik & Hardware-Reverse-Engineering
|
|
- Embedded-Firmware (C/C++)
|
|
- Leiterplattenfertigung & CAD-Design
|
|
- 3D-Druck
|
|
- Astrofotografie
|
|
- Homeserver / Self-Hosting
|
|
- Bierbrauen
|
|
|
|
## Versioning: `YY.MAJOR.MINOR-BUILD`
|
|
|
|
All projects version releases (git tags, changelog entries, artifact
|
|
filenames) as:
|
|
|
|
```
|
|
YY.MAJOR.MINOR-BUILD
|
|
```
|
|
|
|
Example: **`26.0.0-1`**
|
|
|
|
| Field | Meaning | Effect when bumped |
|
|
|---------|------------------------------------------------------|------------------------------|
|
|
| `YY` | Two-digit calendar year of the release | — |
|
|
| `MAJOR` | Breaking / incompatible change | resets `MINOR` → 0, `BUILD` → 1 |
|
|
| `MINOR` | New feature, non-breaking addition | resets `BUILD` → 1 |
|
|
| `BUILD` | Anything else on the same `YY.MAJOR.MINOR` (fix, rebuild, tweak) | +1 |
|
|
|
|
`YY` simply tracks the calendar year the release happened in — it does not
|
|
by itself force a `MAJOR`/`MINOR`/`BUILD` reset. A project can go from
|
|
`25.2.1-4` straight to `26.2.1-5` if nothing breaking or new landed around
|
|
New Year's.
|
|
|
|
### Example progression
|
|
|
|
```
|
|
26.0.0-1 first release of the year, MAJOR 0 / MINOR 0
|
|
26.0.0-2 bugfix rebuild, same MAJOR.MINOR
|
|
26.1.0-1 new feature added -> MINOR bumped, BUILD reset
|
|
26.1.0-2 another small fix
|
|
27.0.0-1 breaking redesign, new year -> MAJOR bumped, MINOR/BUILD reset
|
|
```
|
|
|
|
### Git tags
|
|
|
|
Tag releases as `vYY.MAJOR.MINOR-BUILD`, e.g. `v26.0.0-1`.
|
|
|
|
### Where this shows up
|
|
|
|
- Git tags on the release commit
|
|
- `CHANGELOG.md` (if the project has one)
|
|
- Optionally, a small version string in a project's `docs/index.html`
|
|
footer (see [projects-hub](https://git.joha.mywire.org/jhaas/projects-hub)
|
|
for the hub convention those pages follow)
|