This repository is part of the Refactoring.Guru project.
It contains C# examples for all classic GoF design patterns. Each pattern includes two examples:
- Conceptual examples show the internal structure of patterns with detailed comments.
- RealWold examples show how the patterns can be used in a real-world C# application.
Most examples are console apps built using .NET Core 2.0.
For the best experience, we recommend working with examples with these IDEs:
- Visual Studio 2017 and newer on Windows/Mac.
- Visual Studio Code on any OS.
- Rider on any OS.
We appreciate any help, whether it's a simple fix of a typo or a whole new example. Just make a fork, do your change and submit a pull request.
Here's a style guide which might help you to keep your changes consistent with our code:
-
All code should follow the Microsoft C# code style guide.
-
Try to hard wrap the code at 80th's character. It helps to list the code on the website without scrollbars.
-
The actual examples should be represented by projects with the following naming convention: {PatternName}.{ExampleName}.
-
The code should have the following namespace: RefactoringGuru.DesignPatterns.{PatternName}.{ExampleName}.
-
Aim to put all code within one file. We realize that it's not how it supposed to be done in production. But it helps people to better understand examples, since all code fits into one screen.
-
Comments may or may not have language tags in them, such as this:
// EN: All products families have the same varieties (MacOS/Windows). // // This is a MacOS variant of a button. // // RU: Все семейства продуктов имеют одни и те же вариации (MacOS/Windows). // // Это вариант кнопки под MacOS.
This notation helps to keep the code in one place while allowing the website to generates separate versions of examples for all listed languages. Don't be scared and ignore the non-English part of such comments. If you want to change something in a comment like this, just do it. Even if you do it wrong, we'll tell you how to fix it during the Pull Request.
This work is licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License.
Authors: Alexander Shvets (@neochief) and Alexey Pyltsyn (@lex111)