Your Web News in One Place

Help Webnuz

Referal links:

Sign up for GreenGeeks web hosting
July 27, 2021 12:31 am GMT

Semantic Versioning and Changelog

[Clique aqui para ler em portugus]

All projects should have a semantic versioning, so it would facilitate the use of specific versions as dependencies and old versions for specific platforms or even avoid that bug that appeared in the X.Y.Z version of the project.

Semantic Versioning

Simple set of rules and requirements that determine how version numbers are assigned and in turn incremented.

  • MAJOR: when you make incompatible API changes;
  • MINOR: when you add backward-compatible functionality;
  • PATCH: when you fix backward compatible bugs.

You can read more about the specification at: https://semver.org/

Changelog

When you are going to update a project and want to know what has changed, you go after all the previous releases and the changelog is a file that makes this easier for you and your users.

How to make a good changelog?

Fundamental principles

  • Changelogs are for humans, not machines.
  • There must be an entry for each version.
  • Changes of the same type must be grouped together.
  • Versions and sections must be linked (with links).
  • The latest version comes first.
  • The release date of each version is displayed.
  • Mention whether you follow semantic versioning.

Types of changes

Create your tags to help view the changelog, if you need help here are some patterns:

You can read more about it at: https://keepachangelog.com/

Thanks for reading!

If you have any questions, complaints or tips, you can leave them here in the comments. I will be happy to answer!

See you!


Original Link: https://dev.to/walternascimentobarroso/semantic-versioning-and-changelog-32ad

Share this article:    Share on Facebook
View Full Article

Dev To

An online community for sharing and discovering great ideas, having debates, and making friends

More About this Source Visit Dev To