Article Basics

Author: NikolayPianikov

CONTRIBUTING.md

@@ -55,6 +55,7 @@ The build logic is a regular [.NET console application](/build). You can use [bu
 | perf | Performance tests |
 | pb | Publish the balazor web sssembly example |
 | r | Generate README.md |
+| rel | Get release information |
 | t | Create and deploy templates |
 | te | Test examples |
 | u | Upgrading the internal version of DI to the latest public version |

README.md

@@ -278,6 +278,8 @@ dotnet run
 
 </details>
 
+[An introductory article that will help you understand the basic idea and get started with Pure.DI](/readme/en_art_basics/en_basics.md)
+
 ## Examples
 
 ### Basics
@@ -1989,17 +1991,27 @@ Examples of how to set up a composition
 - [MSBuild logger](https://github.com/JetBrains/teamcity-msbuild-logger/blob/master/TeamCity.MSBuild.Logger/Composition.cs)
 
 Articles
-- [RU New in Pure.DI by the end of 2024](https://habr.com/ru/articles/868744/)
-- [RU New in Pure.DI](https://habr.com/ru/articles/808297/)
-- [RU Pure.DI v2.1](https://habr.com/ru/articles/795809/)
-- [RU Pure.DI next step](https://habr.com/ru/articles/554236/)
-- [RU Pure.DI for .NET](https://habr.com/ru/articles/552858/)
+- [An introductory article that will help you understand the basic idea and get started with Pure.DI](/readme/en_art_basics/en_basics.md)
+
+<details>
+<summary>Additional resources in Russian</summary>
 
-RU DotNext video
+Articles
+- [An introductory article that will help you understand the basic idea and get started with Pure.DI](/readme/ru_art_basics/ru_basics.md)
+- [Pure.DI: new features](https://habr.com/ru/articles/1010646/)
+- [New in Pure.DI by the end of 2024](https://habr.com/ru/articles/868744/)
+- [New in Pure.DI](https://habr.com/ru/articles/808297/)
+- [Pure.DI v2.1](https://habr.com/ru/articles/795809/)
+- [Pure.DI next step](https://habr.com/ru/articles/554236/)
+- [Pure.DI for .NET](https://habr.com/ru/articles/552858/)
+
+DotNext video
 
 <a href="http://www.youtube.com/watch?feature=player_embedded&v=nrp9SH-gLqg" target="_blank"><img src="http://img.youtube.com/vi/nrp9SH-gLqg/0.jpg"
 alt="DotNext Pure.DI" width="640" border="10"/></a>
 
+</details>
+
 ## AI Context
 
 AI needs to understand the situation it’s in (context). This means knowing details like API, usage scenarios, etc. This helps the AI give more relevant and personalized responses. So Markdown docs below can be useful if you or your team rely on an AI assistant to write code using Pure.DI:
@@ -2068,6 +2080,7 @@ The build logic is a regular [.NET console application](/build). You can use [bu
 | perf | Performance tests |
 | pb | Publish the balazor web sssembly example |
 | r | Generate README.md |
+| rel | Get release information |
 | t | Create and deploy templates |
 | te | Test examples |
 | u | Upgrading the internal version of DI to the latest public version |

readme/FooterTemplate.md

@@ -1551,13 +1551,23 @@ Examples of how to set up a composition
 - [MSBuild logger](https://github.com/JetBrains/teamcity-msbuild-logger/blob/master/TeamCity.MSBuild.Logger/Composition.cs)
 
 Articles
-- [RU New in Pure.DI by the end of 2024](https://habr.com/ru/articles/868744/)
-- [RU New in Pure.DI](https://habr.com/ru/articles/808297/)
-- [RU Pure.DI v2.1](https://habr.com/ru/articles/795809/)
-- [RU Pure.DI next step](https://habr.com/ru/articles/554236/)
-- [RU Pure.DI for .NET](https://habr.com/ru/articles/552858/)
+- [An introductory article that will help you understand the basic idea and get started with Pure.DI](/readme/en_art_basics/en_basics.md)
 
-RU DotNext video
+<details>
+<summary>Additional resources in Russian</summary>
+
+Articles
+- [An introductory article that will help you understand the basic idea and get started with Pure.DI](/readme/ru_art_basics/ru_basics.md)
+- [Pure.DI: new features](https://habr.com/ru/articles/1010646/)
+- [New in Pure.DI by the end of 2024](https://habr.com/ru/articles/868744/)
+- [New in Pure.DI](https://habr.com/ru/articles/808297/)
+- [Pure.DI v2.1](https://habr.com/ru/articles/795809/)
+- [Pure.DI next step](https://habr.com/ru/articles/554236/)
+- [Pure.DI for .NET](https://habr.com/ru/articles/552858/)
+
+DotNext video
 
 <a href="http://www.youtube.com/watch?feature=player_embedded&v=nrp9SH-gLqg" target="_blank"><img src="http://img.youtube.com/vi/nrp9SH-gLqg/0.jpg"
 alt="DotNext Pure.DI" width="640" border="10"/></a>
+
+</details>

readme/ReadmeTemplate.md

@@ -222,3 +222,5 @@ dotnet run
 ```
 
 </details>
+
+[An introductory article that will help you understand the basic idea and get started with Pure.DI](/readme/en_art_basics/en_basics.md)

readme/check-for-a-root.md

@@ -313,7 +313,7 @@ Class diagram:
 classDiagram
 	SqlUserRepository --|> IUserRepository : "Primary" 
 	UserService --|> IUserService
-	Composition ..> LightweightRoot : LightweightRoot LightRoot73d
+	Composition ..> LightweightRoot : LightweightRoot LightRoot76d
 	Composition ..> UserService : IUserService Root
 	Composition ..> SqlUserRepository : IUserRepository _
 	UserService *--  SqlUserRepository : "Primary"  IUserRepository
@@ -329,7 +329,7 @@ classDiagram
 	namespace Pure.DI.UsageTests.Hints.CheckForRootScenario {
 		class Composition {
 		<<partial>>
-		-LightweightRoot LightRoot73d
+		-LightweightRoot LightRoot76d
 		+IUserService Root
 		-IUserRepository _
 		+ T ResolveᐸTᐳ()

readme/composition-roots.md

@@ -328,7 +328,7 @@ classDiagram
 	PdfInvoiceGenerator --|> IInvoiceGenerator
 	HtmlInvoiceGenerator --|> IInvoiceGenerator : "Online" 
 	FileLogger --|> ILogger
-	Composition ..> LightweightRoot : LightweightRoot LightRoot73d
+	Composition ..> LightweightRoot : LightweightRoot LightRoot76d
 	Composition ..> HtmlInvoiceGenerator : IInvoiceGenerator OnlineInvoiceGenerator
 	Composition ..> FileLogger : ILogger _
 	Composition ..> PdfInvoiceGenerator : IInvoiceGenerator InvoiceGenerator
@@ -346,7 +346,7 @@ classDiagram
 		class Composition {
 		<<partial>>
 		+IInvoiceGenerator InvoiceGenerator
-		-LightweightRoot LightRoot73d
+		-LightweightRoot LightRoot76d
 		+IInvoiceGenerator OnlineInvoiceGenerator
 		-ILogger _
 		+ T ResolveᐸTᐳ()