Upgrade guide for major versions with breaking changes

[gthvidsten]

I'm working on a .NET Framework solution that uses v1.4 and we would like to upgrade to the latest to fix security dependencies.
There are many breaking changes between these versions and just upgrading and fixing build errors, and then fixing runtime errors, while blindly fumbling around is not a good option.
Are there any lists of breaking changes between the major versions, and/or guides on how to do a proper upgrade between major versions?

[oskarb]

Do you really mean in FluentNHibernate (which is just an add-on for programmatic mappings), or are you really talking about NHibernate itself? The latter sits in the nhibernate-core repository, and I doubt anyone has compiled any list of breaking changes beyond what is written in the release notes:

https://github.com/nhibernate/nhibernate-core/blob/master/releasenotes.txt

[fredericDelaporte]

The recommended process for upgrading is to:

• Upgrade NHibernate to the latest "minor/patch" of your current version.
• Read the release note for the versions between your current version and the latest "minor/patch" of it, and adapt if need be to any breaking change mentioned in them.
• Fix any obsolete warning emitted by compiling your project.
• Test your application thoroughly (optional, but should help, or if unlucky may cause to see troubles fixed by later versions).
• Upgrade to the next "major" version (not the latest).
• Read its release notes and handle any breaking change that would impact your application.
• Test your application thoroughly again (optional, but should help, or if unlucky may cause to see troubles fixed by later versions).
• Repeat from first step, until having reached the latest major/minor/patch.

NHibernate has not followed SemVer from its beginning. So, to make it simple, you should consider as major any version having "GA" in its name in the release notes, and changing the major or the minor number of the version. NHibernate follows SemVer since its 5.0 version.

FluentNHibernate 1.4 depends on Nhibernate 3.3.1, so, that would be at worst four and a half such iterations to do for upgrading NHibernate...

[gthvidsten]

Thanks for the answers :)