Skip to content

v2.3.0

Choose a tag to compare

@Scoz9 Scoz9 released this 25 Jul 14:35
· 7 commits to main since this release

Added

docs/package-guidelines.md — come si versiona e si rilascia un pacchetto scrapkit/*.

architecture-guidelines.md diceva già se creare un pacchetto, e il suo terzo criterio chiede che "someone owns its versioning and changelog" — ma nessun documento diceva cosa significhi possederli. Questo è quel documento:

  • cosa conta come breaking change, concretamente
  • perché 0.x è una sala d'attesa e non una destinazione
  • tag e release: il tag contiene il proprio changelog e non resta mai fuori da main
  • CHANGELOG secondo Keep a Changelog, con le istruzioni di migrazione inline
  • deprecare prima di rimuovere
  • publish tag, chiavi di config e migration come API pubblica
  • constraint ^ nei consumer, @v1 invece di @main per i workflow riusabili

Ogni regola cita il rilascio in cui ignorarla è costato qualcosa.

Changed

architecture-guidelines.md rimanda al nuovo documento dal criterio che lo solleva, e claude/CLAUDE.md lo aggiunge ai doc che Claude consulta prima di versionare o rilasciare un pacchetto.