upgrade.txt

.. _csharp-upgrade-driver:

=======================
Upgrade Driver Versions
=======================

.. facet::
   :name: genre
   :values: reference

.. meta::
   :keywords: update, breaking change, releases
   :description: Identify potential breaking changes when upgrading .NET/C# Driver versions and learn how to minimize application changes using the Stable API.

.. contents:: On this page
   :local:
   :backlinks: none
   :depth: 1
   :class: singlecol

.. toctree::
   :titlesonly:
   :maxdepth: 1

   Version 2.x </upgrade/v2>
   Version 3.0 </upgrade/v3>

Overview
--------

Use the guides on this page to identify the potentially *breaking changes* that each
version of the {+driver-short+} introduces. 
A breaking change is a modification of a convention or a behavior starting in
a specific version of the driver. This type of change may prevent your application from
working properly if you don't address it.

.. tip:: {+stable-api+}

   To minimize the number of changes your application might require when
   you upgrade driver versions in the future, consider using the
   :ref:`{+stable-api+} <csharp-stable-api>`.

.. _csharp-breaking-changes:

Upgrade Guides 
--------------

- :ref:`csharp-upgrade-v2`
- :ref:`csharp-upgrade-v3`