Skip to content

ADR 001 - .NET Version Selection

  • Date: 2025-07-03
  • Status: Active
  • Priority: High

Context

We need to choose a .NET version with a workable support window while still leaving room to move to .NET 10 once it is stable in production.

Problem Statement

Determine the best starting version for the project while balancing support lifetime, stability, and upgrade cost.

Decision

Adopt .NET 9 initially, then plan to upgrade to .NET 10 once it is mature for production use.

Options Considered

  • .NET 8
  • .NET 9
  • .NET 10 from the start

Rationale

  • Avoid starting on a version that is already near end of life.
  • Keep a clear path to .NET 10.
  • Minimize near-term rework while staying modern.

Consequences

Positive

  • Lower risk of near-term platform obsolescence.
  • Flexibility to adopt .NET 10 later.

Negative

  • Some rework may still be needed if .NET 10 introduces breaking changes.