Questions tagged [semantic-versioning]

The practice of using multi part version numbers, such as {major}.{minor}.{bug-fix} or {version}.{release}.{minor}.{level}.

Filter by
Sorted by
Tagged with
0
votes
1answer
172 views

How does a software engineer version two minor updates at the same time?

In a web app I am building, I might finish two distinct minor features at the same time: Implementation of a new web page, and implementation of the notification bar. After merging both of these into ...
0
votes
1answer
149 views

Microservices Versioning - Design Pattern

I have a few questions regarding the versioning in the microservices architecture: Let's say there are three services - S1, S2, S3 S1 calls S2 and S3 to generate a response R1. Service S2 generates ...
1
vote
1answer
95 views

Is it okay to use a patch version in semver when updating documentation?

How does one go about e.g. missing documentation in the source files when using semver? I have just released 1.0 of my library and noticed that a class is missing JavaDoc - is it ok to release a PATCH ...
0
votes
1answer
34 views

Change semver versioning after dropping node eninge versions

I doubt about to which semver version I should update my public NPM package. I didn't change any code, but I had to drop some node engine versions due to a dependency package which had a major update ...
2
votes
2answers
64 views

How to manage updates after a release?

I wonder how should we manage the commits we make AFTER a version is released, according to SEMVER. For example, I just released 1.0.1, now I have 2 choices: Immediately change version to 1.0.2 and ...
1
vote
1answer
90 views

Using semantic version with trunk based development for Python package

I am trying to understand trunk based development with semantic versioning for a Python project. Has anyone had any experience of adopting a trunk based development with semantic versioning for ...
3
votes
1answer
118 views

Semantic Versioning - going from one major version to another?

How should versions be bumped during development between two major versions? For example let say I have version 1.5.0 and my target is to release new major version that will be incompatible with major ...
4
votes
1answer
185 views

What would be the pros and cons of requiring major versions to be forward compatible? [closed]

So I was learning about forward compatibility, and I was wondering if you could warn a "dependent" that a dependency is backward compatible, but not forward compatible*, and vice-versa. The SemVer ...
30
votes
4answers
4k views

When should a commit not be version tagged?

Context: I recently found out about Semantic Versioning, and am trying to determine how to best use it practically for my own projects. Given that semver takes major changes, minor changes, and ...
-1
votes
1answer
73 views

How to use Semantic Versioning on Existing Multi Component Codebase?

I am working on a multi contributor project, having ~2500 Commits. It has multiple components, i.e. Frontend, Backend and Data Processor/DB Ingestion. Now that we are expecting more contributors, a ...
7
votes
2answers
213 views

Semantic Versioning

If a change compiled/built but the semantics were different would it be considered a major change? For example, suppose a time string returned was the same format but now was CET rather than, say, ...
1
vote
2answers
66 views

How to update version when only dependencies are updated?

I have a public project that I'm the single developer. I love updating packages to new versions regularly and keep the project up to date with the updated environment. This is probably not always a ...
1
vote
3answers
68 views

Versioning different flavors built from shared source

I need advice on how to version builds based on shared and separate codes at the same time. I have a gradle project with multiple flavors. Large part of the code is shared. Some parts are flavor ...
4
votes
2answers
1k views

What is a predictable versioning strategy for a monorepo using semver?

To simplify deployment and project management tasks I maintain a monorepo containing several packages that each have a semver version. To be clear, I don't mean several repositories managed from one ...
7
votes
1answer
1k views

Using Gitflow and Semantic Versioning: How to avoid version number conflicts when merging?

I want to use gitflow in combination with semantic versioning. In gitflow, you bump version numbers on every release or hotfix branch. This inevitably leads to version conflicts if a new development ...
1
vote
1answer
276 views

Semantic versioning for content websites

How applicable is it to adapt SemVer for content-centric websites (ie/ not web apps)? Most of the SemVer 2.0.0 specifications able to translate into such type of websites however it becomes vagues ...
2
votes
1answer
85 views

Dependency management for facades/adapters to cloud services (SemVer?)

Suppose I have a library, that basically works as a facade to some cloud service (e.g. JavaScript API that wraps around network calls to some RESTfull service). And once that service introduces a ...
2
votes
1answer
75 views

Version number for multiple softwares coming from same code base

We currently have a big code base from which we can generate 5 differents softwares. The code base is composed of around 20 submodules which are used (or not) by each software. Keeping a semver for ...
5
votes
3answers
317 views

Best practices on sharing code between open source libraries

I have an Android library used by a decent amount of people, let's call it library A. I am building a second library, library B. The two libraries are conceptually related, they solve different ...
-1
votes
1answer
198 views

Multi module project version management

I have a CMake multi module project made of a library and an executable. Both the root project and each sub module has its own version (major.minor.patch). I would like to know how to handle each ...
4
votes
3answers
1k views

Is a breaking change bug fix a semver patch or a major?

Your package has a bug. Its API in some scenarios doesn’t follow the documentation and the intended behaviour. It has been that way since it was v1.0.0. You fix it to match the documentation. Should ...
-2
votes
2answers
166 views

What should be the version of the very first build of a software? [closed]

As the title explains the question, let's assume that we're using versioning as major.minor.revision.build. What should the initial version of a software build be? 0.0.0.1 or 0.0.0.0 or anything else?
1
vote
2answers
73 views

Should each new feature for an open source project have a new minor version?

I develop an open-source project. According to this webpage, you should increment the "MINOR version when you add functionality in a backwards-compatible manner". Suppose I'm developing two distinct ...
2
votes
3answers
797 views

How to version, with semantic version, when a bug is fixed between a stable version and unstable version

I have a doubt with semantic versioning. I'm working with semantic version like is shown in semver Imagine this scenario: A stable version, named as 1.1.0 An unstable version, named as 1.1.1-rc1 A ...
3
votes
1answer
183 views

Publishing versions out of order

Does npm allow you to publish earlier versions of a package? The only documentation I could find was on npm’s site: [npm-publish] Fails if the package name and version combination already exists in ...
0
votes
1answer
47 views

How can I do production like deployments using a artifact server that enforces semantic versioning with artifacts that haven't received a version yet?

Just a small bit of background. Right now my team tags release candidates in version control. I've learned that this may not be the best thing to do because we still have to go through user acceptance ...
3
votes
1answer
504 views

When do I update the Git repo package.json/version release?

I am starting to get into versions/releases more now with Git and wanted to know if the structure I am doing now is correct. Right now, there is typically a few feature branches. A few commits from ...
4
votes
1answer
644 views

Semantic versioning with bugfixes and new features in the same release

After reading a lot about semantic versioning I got a basic understanding of the concept but I'm not sure what's the best way to increment the version number in the following case: Let's pretend that ...
1
vote
2answers
688 views

Major version number as part of package name / namespace?

Background In a software ecosystem where different packages depend on different versions of other packages, sometimes dependency resolution ends in a version conflict. Example: Root package A ...
0
votes
1answer
124 views

Does doc comments count as declaring a public API?

I've been reading about semantic versioning. Software using Semantic Versioning MUST declare a public API. This API could be declared in the code itself or exist strictly in documentation. ...
0
votes
1answer
690 views

artefact versioning - product versioning vs semantic versioning

The following situation: a product which consists of multiple components, each component versioned individually (all artefacts of the same component having the same version) POs are talking of ...
-1
votes
1answer
216 views

How to maintain multiple or single repositories of a project developed by multiple people?

A while ago, I asked what are cons and pros between the two version control designs of a project: multiple repositories, vs single repository When a project has a single git repository and developed ...
1
vote
1answer
359 views

Does Semantic Version use zero-based numbering?

Does 1.0.0 represent the first patch of the first minor version of the second major version? Or does it represent the first major version, with no minor or patch versions? I've always assumed it to be ...
1
vote
3answers
929 views

What Does Backwards Compatible Mean If There Are Breaking Changes

I've noticed something strange in a few open source projects that use Semantic Version. In React 15, the React team switched to semver. Similarly, the Angular team switched to semver in Angular 2.0.0. ...
4
votes
2answers
611 views

Semantic Versioning in OpenAPI with string “enum”: new values OK?

My team is preparing to add new capabilities to an OpenAPI contract and our implementation of it. There are pre-existing clients. We are planning to take our API from v1.1 to v1.2 while fully ...
3
votes
2answers
450 views

Semantic Version Change (to application) when Upgrading Libraries Involved

So I have an application that utilizes 14 different libraries. It's been a while since I have updated this application and one or more of the libraries involved have since experienced a major revision ...
7
votes
3answers
1k views

How to use Git Flow with multiple dependant projects

We are trying to work through an effective branching strategy for our organization so releases, versioning and such are all handled consistently. We have many C#-based solutions, each with anywhere ...
16
votes
4answers
916 views

Is fast major version bumping an evidence of poor design?

I started a job as junior programmer a few months ago. The system we are working on has been in production for ~2 years. I wasn't involved in the begging of the system and the design. One thing I ...
4
votes
1answer
187 views

How to convert the last rc (or other pre-release) into the production version using semver?

Semantic versioning encourages using suffixes to indicate pre-releases: alpha, beta or rc builds. Their purpose is well known and documented. It's also a given that once you create a build or version,...
4
votes
1answer
103 views

How to version a project with dependencies and data sources

My apologies if my question is not gonna be clear as I do not have experience in the domain of versioning products/projects. And starting: I have a project which has multiple libraries and data ...
4
votes
0answers
730 views

What version numbers should I assign to builds on different branches as part of continuous integration for NET Core-based projects?

Overview I'm developing a number of .NET Core applications and I've met my current sprint commitments early. Until my next sprint begins, I'm using the slack to look into setting up a CI pipeline for ...
2
votes
1answer
177 views

Major or Minor Revision Change when Implementing an Interface

I am using semantic versioning 2.0.0. In my situation I have a concrete implementation of some interface A in one library. And I have the interface that's being implemented (call it B) in another ...
2
votes
1answer
170 views

Is it appropriate to use Semantic Versioning for the specification for a key/value file format?

I'm writing a Python tool to convert/store the data from a commonly used plaintext file format for volumetric data generated by computational chemistry calculations into the binary HDF5 format using ...
0
votes
2answers
129 views

Software package versioning confusion

I am working in embedded software domain and my primary work area is development of firmware for various MCUs. I follow the folder structure as mentioned below for any firmware project to release the ...
4
votes
5answers
842 views

What Semantic Version increment to use for a configuration file alteration?

Using Semantic Versioning, I have a product that is version 1.0.0. It has a configuration file entry shipped with the product that specifies an operation timeout value: myTimeout=1000 I need to ...
5
votes
1answer
267 views

Multiple git repositories with a common core lib

I have several git repositories for a web project that share a library of common code. I don't want to repeat the common code inside for each repo. What are some ways others have solved this problem? ...
2
votes
2answers
1k views

How to version when using trunk based development

I have been reading a bit more about trunk based development, my company currently mainly uses the git flow model, and I had a question regarding the commits that happen on the trunk and how they are ...
2
votes
1answer
64 views

Is it appropriate to convert a project to a different language and keep the same versioning?

Say there's a package, foo. Foo is being developed primarily in Python, up until version 1.13.2. At that point in time, the primary developer decides that Go is much better suited to the task. He ...
-1
votes
2answers
612 views

Why do developers love using code-names instead of actual version numbers? [closed]

99% of software comes in different versions. And quite often developers like naming versions. Example - Android versions: Froyo Gingerbread Ice Cream Sandwich etc.. It really bothers me because it ...
1
vote
3answers
185 views

How to differentiate versioning between changes on version 1.0 and adding new features towards 2.0?

If I met all requirements on version 1.0 and go on working towards version 2.0, new features would be 1.1, 1.2, 1.3, and so on. What do I version the commits that represent an important fix or a ...