Questions tagged [versioning]
Versioning is the way in which successive versions of the same software are identified using unique version names or unique version numbers.
332
questions
0
votes
2
answers
131
views
Is a 'base' file always necessary when doing a merge?
Are there any algorithms that can do or suggest merges without requiring the "base" file, the most recent common ancestor of the two file versions that we want to merge?
Is a manual merge ...
- 2,287
0
votes
0
answers
70
views
Is there a name for this partially ordered versioning scheme?
Versions are on the form:
x.y.z.[..]
Where these letters are numbers and there are arbitrarily many of them.
The first version is 1. The next one is 2. The only time when you
branch out to the next ...
- 252
4
votes
3
answers
2k
views
How to modify workflow to allow multiple features per release?
This question is inspired by comments on this recent question. In that question I asked about a version tagging workflow. A few commenters suggested it was a little strange that I'm tagging and ...
- 185
1
vote
2
answers
306
views
How to automate version bumping, when version bumping involves changes in source code and a git tag?
I have a small open source package and I'm trying to automate parts of the release life cycle. I am very confused about how to automate version bumps. Here's the relevant information about my version ...
- 185
1
vote
2
answers
225
views
When should release versions be bumped?
I want my projects to be SemVer compliant. I follow a trunk-based development approach. I also want to keep things as simple as possible.
I assume that each commit on main (default branch) is a ...
- 119
-1
votes
1
answer
15
views
How to use versions-maven-plugin with shared contracts?
Context:
We have Java maven Multi Microservices Project.
The structure for each microservice is a contracts package and a service package.
When we update a version of a specific microservice the ...
- 101
1
vote
4
answers
253
views
Do you increment software version when updating non-functional parts of the code such as deployment scripts or README file?
Currently, my repo contains application code and what I call non-functional files, which include deployment scripts, README file, build system requirements, dependencies etc. These files are released ...
- 233
0
votes
2
answers
107
views
How to seperately deploy two components of the presentation layer that both make use of one business component?
Context
I have a multi-tiered architecture that contains 2 presentation layers, one business layer and one data layer. See image below for a visualisation.
Here you can see that there are two ...
- 19
2
votes
4
answers
800
views
How do you deploy and test a hotfix repo branch in different environments, Git Flow variants
I have done thru where do bug fixes go in git flow and the git flow and github flow pages.
There are scenarios many times when we need to show demo of new functionality and on same day fix issues of ...
- 595
0
votes
1
answer
89
views
How to decide when to increase the minimum supported C++ standard version?
I'm maintaining a library written in C++, which offers modern-C++ bindings for another API that's C-ish (it's this one, although I'm trying to make this question somewhat more general).
Now, when I ...
- 2,488
0
votes
2
answers
80
views
How do I control many datasets that are related and can change independently?
Background: I'm a scientist working with a small team on data analytics. No one on our team has any experience with software engineering, though I'm trying to change that.
Suppose I have an array A ...
- 87
2
votes
1
answer
121
views
Best way to handle versioning between a desktop product and a cloud product when one depends on the other
Let's say that there are two products, product A and product B.
Product A is a desktop product that customers download and install locally on their machine. This product follows a typical versioning ...
1
vote
2
answers
93
views
What is the most efficient approach about dependencies versions?
Recently I had many problems opening old projects, which had all dependencies in package.json defined with ^ x.y.z. When I pull the code and run npm install the dependencies are installed but I will ...
- 113
5
votes
1
answer
181
views
Keeping version parity between platforms
I'm in the mobile development domain and I use semantic versioning to version my releases. I keep both versions the same as long as new builds are released for both iOS and Android platforms at the ...
- 391
1
vote
3
answers
180
views
Low maintenance approach to handling versioning and git
What is a good way of handling version bumps in git history?
The best approach that I've found so far is something like this:
Version is specified in one of the source files (e.g. Python's __version__)...
- 97
12
votes
4
answers
4k
views
Guidance on rectifying a minor bump that should have been a major bump
We have product X which has the following semver versions: 1.0.0, 1.1.0, 1.2.0, ..., 1.10.0.
In version 1.5.0, we introduced a feature which changes the way the application is consumed in a big way. ...
- 139
12
votes
2
answers
2k
views
How do I choose a versioning scheme when Semantic Versioning (SemVer) isn't appropriate?
All too often, I see people people pointing out flaws in Semantic Versioning (SemVer), or pointing out that it doesn't apply to huge categories of software. (See quotes below).
In particular,
SemVer ...
- 1,432
43
votes
5
answers
10k
views
What is the significance of reaching major version 1.0.0?
I have seen many open source projects being labelled as "not production ready" because they have not reached a major version e.g. 1.0.0 using semver.
What is the significance of reaching ...
- 565
18
votes
5
answers
4k
views
What Semantic Version increment to use for a filename change?
I have a program that runs on command-line, let's call it myprogram 1.0.1. It's published on GitHub.
Now I discovered that name already exist for a well-know software, so I want to change the name ...
- 309
2
votes
3
answers
248
views
Static types and dependencies in trunk-based development
There're certain things in code that can't be conditional. Two very common examples:
static types
dependencies.
You can't naturally enable/disable a feature that implies a new dependency or a new ...
- 139
2
votes
3
answers
1k
views
Semantic versioning on a dev dependencies change
There are a few threads about how to handle the version number with semver upon changes in dependencies (usually resulting in a +1 to the patch number). Mine is probably a corner case: what if you are ...
- 147
4
votes
2
answers
1k
views
What kind of version change is updating to a new .NET-version when using SemVer?
When updating to a new major version of .NET (in this case from .NET 5 to .NET 6) without needing to make any change other than selecting the new target framework in Visual Studio, does this warrant a ...
- 61
0
votes
0
answers
49
views
Database versioning when testing layered design
Let's say there are two layers of an application:
Business logic layer
Data access layer
Assume integration tests need to be written also for the Business logic layer. Alas tests that run against ...
0
votes
0
answers
218
views
Keeping a fork of a repository up-to-date with upstream changes
I have a repository, which is a fork of a public project. The fork contains several additional commits with custom features - nothing fancy. Recently, I have been wondering what would be the best ...
- 109
1
vote
1
answer
304
views
Should serializable classes have different serialization versions?
I am distributing a proprietary library that includes multiple serializable classes (serializable to a file). I want versioning to the serializable classes, i.e. when serializing I put the version ...
- 29
1
vote
0
answers
724
views
Versioning JSON data in db
I'm curious if there are any obvious pitfalls to the following:
I have a database table that, because it is storing many objects of various subclasses, I'm using a JSON field to hold the non-...
- 111
0
votes
0
answers
36
views
Nuget Libraries - Avoid version Conflicts
we have a private nuget repo setup available for all department developers, each developers can contribute and deploy their own reusable library which gets uploaded for the entire dev team to use ...
- 1
7
votes
5
answers
2k
views
Version REST APi as a whole, or by endpoint
I had a discussion with a colleague of mine today regarding versioning of a REST Api.
We currently have an API with support for versinong by providing the correct version in the URL.
So for instance:
...
- 261
0
votes
0
answers
306
views
Why doesn't golang have a version number built into go.mod
I've recently been learning go and the versioning system seems rather odd to me. Most languages / dependency management systems that I'm familiar with (like rust and cargo) have an explicit way to ...
- 109
1
vote
2
answers
175
views
GitHub Versioning - Organizing Structure
I am making a JS library that creates graphs and charts using canvas. I have hosted it on GitHub as a public repository.
So after looking at some other related questions, I have figured out two ...
- 23
1
vote
2
answers
1k
views
Semantic versioning for SPA applications with a RESTful backend
I am building an Angular web application with a RESTful backend. I plan on using semantic versioning to differentiate between different releases. I've already read a bit about how to implement ...
- 133
0
votes
1
answer
172
views
REST API Per-Method Versioning
New to writing REST APIs. Had a question about versioning.
Let's say that we have a service with the following methods:
Search <- Given some data, it will perform a search
Billing <- Given a ...
- 155
-3
votes
3
answers
151
views
Should a major version increase indicate cutting-edge or rounded-out?
I'm working on a FOSS library whose versions are all 0.x.y . I am wondering when to bump the version up to 1.0.
On the one hand, the switch from 0 to 1 suggests a level of maturity, of the software ...
- 2,488
6
votes
1
answer
603
views
Is changing the exception a method throws a breaking change for a library?
I have a library that I am distributing on maven in the new version I will be changing the exceptions some methods are throwing. Is this considered a breaking change? If this is the only change in the ...
- 81
-1
votes
2
answers
912
views
How to access version of a Java application programmatically when running from an IDE?
As far as I understand, the best practice for programmatic access to the version of a Java application is to:
Specify version via build system (e.g. in Gradle).
Include the version string as a ...
- 113
2
votes
2
answers
326
views
Fix internal library versions or always use the latest one?
Given we have several data transformation applications, which e.g. load an image, do some calculation and save some output. They make use of several internal libraries (internal = developed at our ...
- 241
0
votes
2
answers
195
views
How to manage ongoing development of two variants of the same library?
I'm the developer and maintainer of a FOSS C++ library, call it libfoo.
There used to be just one variant of it; and I've made several numbered releases. Last year, I've created a second variant of ...
- 2,488
-2
votes
1
answer
153
views
Version naming for source code with multiple build targets
I have a Java library which is deployed automatically to Maven central. Right now this library has Java-1.8 target SDK, I want to continue releasing source code with this target and add new target ...
- 126
0
votes
2
answers
158
views
How to version modules that depend on different framework versions
I work as a Website developer. We use a framework for building the backend of our sites.
This framework recently released a new major version with lots of breaking changes. We have some sites using ...
- 111
1
vote
1
answer
126
views
Dealing with queries on versioned data
I have a dataset stored in ElasticSearch, only for searching purposes (the source of truth is external).
Each index has an associated schema and there are associated queries.
From time to time, the ...
- 127
0
votes
2
answers
656
views
Why is master branch important in GitHub flow?
First let me phrase my understanding of GitHub flow before asking the question:
In GitHub flow, we have a main branch, and feature/topic/bugfix/whatever branches branching off that main branch. Once ...
- 172
2
votes
4
answers
917
views
Component Versioning - What is the importance and what are the advantages?
In my group we are debating whether to version each one of our system components or not.
While I find many talk about "how" to version each component (semver for example) I don't find enough ...
- 137
0
votes
1
answer
423
views
How to set up 2 versions of Single Page Application and serve the right version to users based on the backend setting?
We develop a Single Page Application (SPA) for enterprise clients. When we deploy a new version of our SPA we would like to upgrade a subset of clients whilst leaving the other clients on the more ...
- 3,095
-1
votes
2
answers
690
views
How to version bug fix of library for earlier release?
I'm kinda new in versioning.
In my scenario, for example, our main project is currently developing in 2.1.0 (develop branch), while the library version remain same as 1.5.0 since nothing change (for ...
- 17
-2
votes
1
answer
112
views
Merge migrations from two different servers
I'm working on a project that has two separate versions of the API, v1, and v2 because they wanted to migrate from Javascript to Typescript. Both versions use the same database.
Recently I'm having ...
- 5
1
vote
3
answers
456
views
Questions about software versioning
I have a small doubt regarding the software versioning, I know that there are many ways to do it, but the most common is with numbers and with a length of 3 to 4 digits, I know what each of the ...
- 557
4
votes
1
answer
1k
views
Which SemVer version to use between releases?
I'm working on a project that uses Semantic Versioning. The commit history can be generalized as:
Also, the current version is present in source code (so that the software can use it for various ...
- 159
3
votes
3
answers
1k
views
Avoid "Updated version number" commits
I have softwares whose version number are stored either in a versionned commit file or in the code (main header file for example)
Because of that before every release we have to update the version ...
- 1,020
2
votes
3
answers
1k
views
Design patterns to handle multiple file formats and versions
I've read both visitor&strategy patterns are a good choice when it comes to export data into multiple file formats. I'd like to understand how to apply both so I've created a really simple dummy ...
- 455
2
votes
2
answers
965
views
Domain driven design model version
sorry for the long question, but I love DDD but there is a problem I can't seem to resolve.
We have a problem when adding business rules to the aggregate root.
Our architecture is mostly like this ...
- 29