ardalis/CleanArchitecture

Official Migration Guide

Open

#992 opened on Jan 27, 2026

View on GitHub
 (1 comment) (0 reactions) (0 assignees)C# (18,176 stars) (3,062 forks)batch import
enhancementhelp wanted

Description

I'm requesting an official migration guide to help projects upgrade the template.

Currently, I'm on version 10.0.1 and would benefit from an official migration guide to version 11.0.0. Based on my review of the release notes, it appears that some components like MediatR may have been replaced or changed in the newest version (due to commercial stuff). Therefore, it would be helpful if there was either an automatic upgrade process or at least a comprehensive guide for upgrading the template.

This would help ensure a smooth migration path and reduce the risk of missing important changes or breaking updates.

Contributor guide

Tech stack
csharp
Domain
documentation
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Familiarity with CleanArchitecture templateUnderstanding of versioning and releases
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
60
Research direction
Review the release notes for version 11.0.0 and the current 10.0.1 template. Identify all breaking changes and new features. Create a step by step guide that explains how to update project structure, dependencies (e.g., MediatR replacement), and configuration. Ensure the guide is clear and includes code snippets or links where appropriate.