# 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)