Laden...

Symbole / Legende für Changelog?

Letzter Beitrag vor 2 Jahren 5 Posts 1.375 Views
Symbole / Legende für Changelog?

Ich hatte vor einiger Zeit mal einige Changelogs gesehen, die mit Symbolen, bzw. Zeichen arbeiten, also Beispiel:


[+] = Neue Funktion / neues Feature
[-] = Entfernte Funktion / Entfernte Funktion
[~] = Diverses
usw.

Mir gefällt das System. Ich suche nun die Zeichen für


[] Update Feature / Funktion / Änderung
[] Fix
[] Deprecated 

Ich finde zu dieser Art von Changelog schreiben nichts mehr. Ist das komplett out bzw. außerhalb des Standards und man schreibt es normal, also


[Add]
[Remove]
[Update]
[Fix]
usw.

IDE: Visual Studio 2022
Sofern nicht anders genannt basieren meine Projekte auf C# und .net 6

Schaue Dir mal https://keepachangelog.com/ an.

Ist das komplett out bzw. außerhalb des Standards

Es gibt keine Standards, nur "best practises", die sich entwickelt haben.
Symbole gehören definitiv jedoch nicht dazu.

Changelogs werden für Menschen gemacht, nicht für Maschinen - also machs für Menschen einfach.
Und dazu gehört, dass Änderungen gruppiert werden; zB neue Funktionen eben in einer "Added"-Section, Breaking Changes eben in einer extra "Breaking Changes", um diese zu verdeutlichen.
So ist das üblich. So machen das auch die weit verbreiten Tools - nicht mit Symbolen.

OK, Danke.

IDE: Visual Studio 2022
Sofern nicht anders genannt basieren meine Projekte auf C# und .net 6

Im Prinzip musst nur du und die Leute die du informieren willst damit klar kommen.
Ich kenne vom sehen auch "+" Added, "*" changed, etc.

Schöner zu lesen ist natürlich ausgeschrieben. Finde folgende Releasenotes immer ganz übersichtlich gemacht:
https://github.com/Hypfer/Valetudo/releases