add some links

mehdihadeli · Jul 10, 2023 · 713044d · 713044d
1 parent 55e74d1
commit 713044d
Show file tree

Hide file tree

Showing 59 changed files with 366 additions and 116 deletions.
diff --git a/docs/api-documentation.md b/docs/api-documentation.md
@@ -4,9 +4,10 @@
 [Swagger Github](https://github.com/domaindrivendev/Swashbuckle.AspNetCore/blob/master/README.md)
 
 ## 📕 Articles
-
 - [OpenAPI support in minimal APIs - ASP.NET Core](https://learn.microsoft.com/en-us/aspnet/core/fundamentals/minimal-apis/openapi) ⭐
 - [Understanding Swagger integration in .NET Core](https://www.code4it.dev/blog/swagger-integration) 
+- [Get started with NSwag and ASP.NET Core](https://learn.microsoft.com/en-us/aspnet/core/tutorials/getting-started-with-nswag) ⭐
+- [Get started with Swashbuckle and ASP.NET Core](https://learn.microsoft.com/en-us/aspnet/core/tutorials/getting-started-with-swashbuckle) ⭐
 - [How to generate code from OpenAPI definition with Visual Studio 2019](https://www.code4it.dev/blog/openapi-code-generation-vs2019)
 - [ASP.NET Core web API documentation with Swagger / OpenAPI](https://docs.microsoft.com/en-us/aspnet/core/tutorials/web-api-help-pages-using-swagger)
 - [Getting Started with Swashbuckle](https://docs.microsoft.com/en-us/aspnet/core/tutorials/getting-started-with-swashbuckle)
@@ -36,9 +37,21 @@
 - [OpenAPI vs. Swagger](https://learn.microsoft.com/en-us/aspnet/core/tutorials/web-api-help-pages-using-swagger?view=aspnetcore-5.0#openapi-vs-swagge)
 - [OpenAPI Specification on by default](https://learn.microsoft.com/en-us/aspnet/core/release-notes/aspnetcore-5.0?view=aspnetcore-5.0#openapi-specification-on-by-default)
 - [Generate C# client for OpenAPI - NSwag](https://kaylumah.nl/2021/05/23/generate-csharp-client-for-openapi.html) ⭐⭐
-- [Get started with Swashbuckle and ASP.NET Core](https://learn.microsoft.com/en-us/aspnet/core/tutorials/getting-started-with-swashbuckle) ⭐
 - [What is AddEndpointsApiExplorer in ASP.NET Core 6](https://blog.devgenius.io/what-is-addendpointsapiexplorer-in-asp-net-core-6-64ba52d15979) ⭐
 - [What is AddEndpointsApiExplorer in ASP.NET Core 6 - StackOverflow](https://stackoverflow.com/a/71933535/581476) ⭐
+- [Understanding  the API-First Approach to Building Products](https://swagger.io/resources/articles/adopting-an-api-first-approach/)
+- [How Wix Accelerated Open Platform Dev with Standardized APIs & Schemas](https://medium.com/wix-engineering/how-wix-accelerated-open-platform-dev-with-standardized-apis-schemas-e4fbbf25f5d8)
+- [Contract first OpenAPI development (but still use Swagger UI with ASP.NET Core)](https://blog.codingmilitia.com/2023/04/02/contract-first-openapi-development-but-still-use-swagger-ui-with-asp.net-core/) ⭐
+- [Using OpenApiReference To Generate Open API Client Code](https://stevetalkscode.co.uk/openapireference-commands)
+- [NSwag.MSBuild](https://github.com/RicoSuter/NSwag/wiki/NSwag.MSBuild) ⭐
+- [NSwag Configuration Document](https://github.com/RicoSuter/NSwag/wiki/NSwag-Configuration-Document) ⭐
+- [Creating Discoverable HTTP APIs with ASP.NET Core 5 Web API](https://devblogs.microsoft.com/dotnet/creating-discoverable-http-apis-with-asp-net-core-5-web-api/)
+- [Open-source HTTP API packages and tools](https://devblogs.microsoft.com/dotnet/open-source-http-api-packages-and-tools/)
+- [Generating HTTP API clients using Visual Studio Connected Services](https://devblogs.microsoft.com/dotnet/generating-http-api-clients-using-visual-studio-connected-services/) ⭐
+- [How to generate a swagger.json file on build in .NET core](https://medium.com/@woeterman_94/how-to-generate-a-swagger-json-file-on-build-in-net-core-fa74eec3df1) ⭐
+- [Generating HTTP API clients using dotnet tools and Visual Studio Connected Services](https://dotnetthoughts.net/generating-http-api-clients-using-dotnet-tools/)
+- [.NET OpenAPI tool command reference and installation](https://learn.microsoft.com/en-us/aspnet/core/web-api/microsoft.dotnet-openapi)
+- [Using OpenApiReference To Generate Open API Client Code](https://stevetalkscode.co.uk/openapireference-commands) ⭐
 
 ## 📺 Videos
 - [Extended Swagger documentation | ASP.NET Core 5 REST API Tutorial 22](https://www.youtube.com/watch?v=BGASedyh16I)
@@ -50,6 +63,8 @@
 - [Insomnia Software Playlist - Kong](https://www.youtube.com/playlist?list=PLg_AhYkg50vjKpcFY6S8d7u-FpKk9EBYA)
 - [Insomnia walkthrough](https://www.youtube.com/watch?v=H_k8Z8Zq99s)
 - [Insomnia REST Client – Getting Started with the Sendwithus API](https://www.youtube.com/watch?v=lPFOEufD6mQ)
+- [ASP.NET Community Standup - Building HTTP APIs](https://www.youtube.com/watch?v=Mpf0fCO6NrU) ⭐
+
 ## Libraries
 - [dmitry-pavlov/api-client-generation-tools](https://github.com/dmitry-pavlov/api-client-generation-tools) - API Client Generation Tools for Visual Studio, Visual Studio Code, and JetBrains Rider
 - [RicoSuter/NSwag](https://github.com/RicoSuter/NSwag) - The Swagger/OpenAPI toolchain for .NET, ASP.NET Core and TypeScript.
@@ -62,4 +77,7 @@
 - [unchase/Unchase.Swashbuckle.AspNetCore.Extensions](https://github.com/unchase/Unchase.Swashbuckle.AspNetCore.Extensions) - Swagger tools for documenting API's built on ASP.NET Core
 ## Samples
 - [dotnet/aspnet-api-versioning/WebApi/MinimalOpenApiExample](https://github.com/dotnet/aspnet-api-versioning/tree/93bd8dc7582ec14c8ec97997c01cfe297b085e17/examples/AspNetCore/WebApi/MinimalOpenApiExample)
-- [dotnet/aspnet-api-versioning/WebApi/OpenApiExample](https://github.com/dotnet/aspnet-api-versioning/tree/93bd8dc7582ec14c8ec97997c01cfe297b085e17/examples/AspNetCore/WebApi/OpenApiExample)
+- [dotnet/aspnet-api-versioning/WebApi/OpenApiExample](https://github.com/dotnet/aspnet-api-versioning/tree/93bd8dc7582ec14c8ec97997c01cfe297b085e17/examples/AspNetCore/WebApi/OpenApiExample)
+- [joaofbantunes/MinimalVersionedOpenApiSample](https://github.com/joaofbantunes/MinimalVersionedOpenApiSample)
+- [joaofbantunes/SwaggerUiWithoutGenSample](https://github.com/joaofbantunes/SwaggerUiWithoutGenSample)
+- [cezarypiatek/SampleWebApiClientGeneration](https://github.com/cezarypiatek/SampleWebApiClientGeneration)
diff --git a/docs/asp/asp-net-7.md b/docs/asp/asp-net-7.md
@@ -16,6 +16,7 @@
 - [Performance improvements in ASP.NET Core 7](https://devblogs.microsoft.com/dotnet/performance-improvements-in-aspnet-core-7/)
 - [Announcing ASP.NET Core in .NET 7](https://devblogs.microsoft.com/dotnet/announcing-asp-net-core-in-dotnet-7/)
 - [What's new in ASP.NET Core 7.0](https://learn.microsoft.com/en-us/aspnet/core/release-notes/aspnetcore-7.0)
+- [Problem Details responses everywhere with ASP.NET Core and .NET 7](https://www.strathweb.com/2022/08/problem-details-responses-everywhere-with-asp-net-core-and-net-7/)
 
 ## Videos
 - [ASP.NET Core in .NET 7 Preview 1 - What you need to know](https://www.youtube.com/watch?v=VgmsFck3RWU)

diff --git a/docs/asp/asp-net-8.md b/docs/asp/asp-net-8.md
@@ -0,0 +1,9 @@
+# ASP.NET 8
+
+## Articles
+- [ASP.NET Core updates in .NET 8 Preview 1](https://devblogs.microsoft.com/dotnet/asp-net-core-updates-in-dotnet-8-preview-1/)
+- [ASP.NET Core updates in .NET 8 Preview 2](https://devblogs.microsoft.com/dotnet/asp-net-core-updates-in-dotnet-8-preview-2/)
+- [ASP.NET Core Route Tooling Enhancements in .NET 8](https://devblogs.microsoft.com/dotnet/aspnet-core-route-tooling-dotnet-8/)
+- [ASP.NET Core updates in .NET 8 Preview 3](https://devblogs.microsoft.com/dotnet/asp-net-core-updates-in-dotnet-8-preview-3/)
+- [ASP.NET Core updates in .NET 8 Preview 4](https://devblogs.microsoft.com/dotnet/asp-net-core-updates-in-dotnet-8-preview-4/)
+- [ASP.NET Core updates in .NET 8 Preview 5](https://devblogs.microsoft.com/dotnet/asp-net-core-updates-in-dotnet-8-preview-5/)
diff --git a/docs/csharp/async/async-and-await.md b/docs/csharp/async/async-and-await.md
@@ -69,6 +69,7 @@
 - [ASP.NET Core - Why async await is useful](https://steven-giesel.com/blogPost/b925c8c1-03ba-4eb6-9b81-f09df56e0158)
 - [No, No, No - Tasks are not threads and they are not for performance!](https://steven-giesel.com/blogPost/d095383f-7ea9-4419-96b8-889c6981cce0)
 - [Asynchronous Programming Patterns in .NET](https://code-maze.com/asynchronous-programming-patterns-dotnet/)
+- [How Async/Await Really Works in C#](https://devblogs.microsoft.com/dotnet/how-async-await-really-works/)
 
 ## 📹 Videos
 - [Why Asynchronous Web API Endpoints | RESTful | async await](https://www.youtube.com/watch?v=TnfCu7Osy-Q&ab_channel=FrankLiu)

diff --git a/docs/csharp/async/concurrency -vs-parallelism.md b/docs/csharp/async/concurrency -vs-parallelism.md
@@ -7,11 +7,17 @@
 - [Serial vs Parallel task execution](https://www.davidguida.net/serial-vs-parallel-task-execution/)
 - [Difference between Concurrency and Parallelism](https://www.geeksforgeeks.org/difference-between-concurrency-and-parallelism/)
 - [Concurrency vs. Parallelism](http://tutorials.jenkov.com/java-concurrency/concurrency-vs-parallelism.html)
-- [Concurrency vs. Parallelism — A brief view](https://medium.com/@itIsMadhavan/concurrency-vs-parallelism-a-brief-review-b337c8dac350)
+- [Concurrency vs. Parallelism — A brief view](https://medium.com/@itIsMadhavan/concurrency-vs-parallelism-a-brief-review-b337c8dac350) ⭐
 - [How to use Multithreading and Multiprocessing - A Beginner's guide to parallel and concurrent programming](https://www.mineiros.io/blog/guide-to-multihreading-and-multiprocessing)
 - [What is the difference between asynchronous programming and multithreading?](https://stackoverflow.com/questions/34680985/what-is-the-difference-between-asynchronous-programming-and-multithreading/34681101#34681101)
 - [Inside the Concurrent Collections](https://www.red-gate.com/simple-talk/blogs/inside-the-concurrent-collections/)
 - [Inside the Concurrent Collections: ConcurrentDictionary](https://www.red-gate.com/simple-talk/blogs/inside-the-concurrent-collections-concurrentdictionary/)
+- [Difference Between Asynchronous Programming and Multithreading in C#](https://code-maze.com/csharp-async-vs-multithreading/)
+- [What is the difference between concurrency, parallelism and asynchronous methods?](https://stackoverflow.com/a/61225458/581476) ⭐
+- [Concurrency vs Parallelism](https://www.baeldung.com/cs/concurrency-vs-parallelism)
+- [Concurrency vs Parallelism](https://freecontent.manning.com/concurrency-vs-parallelism/) ⭐
+- [Asynchronous programming with async and await](https://learn.microsoft.com/en-us/dotnet/csharp/asynchronous-programming/) ⭐
+
 ## Videos
 - [Concurrency vs Parallelism](https://www.youtube.com/watch?v=FChZP09Ba4E)
 - [Concurrency vs Parallelism | C# Interview Questions | Csharp Interview Questions and Answers](https://www.youtube.com/watch?v=8Je1W82vwYM)

diff --git a/docs/csharp/record.md b/docs/csharp/record.md
@@ -1,16 +1,21 @@
 # Record
 
 ## 📕 Articles
+- [Create record types](https://learn.microsoft.com/en-us/dotnet/csharp/whats-new/tutorials/records)
+- [Records (C# reference)](https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/builtin-types/record)
+- [C# 9.0 on the record](https://devblogs.microsoft.com/dotnet/c-9-0-on-the-record/)
 - [C# 9 Deep Dive: Records](https://www.daveabrock.com/2020/07/06/c-sharp-9-deep-dive-records/)
 - [Avoid C# 9 Record Gotchas](https://khalidabuhakmeh.com/avoid-csharp-9-record-gotchas)
-- [C# 9.0 on the record](https://devblogs.microsoft.com/dotnet/c-9-0-on-the-record/)
 - [C# 9.0: Records – Work With Immutable Data Classes](https://www.thomasclaudiushuber.com/2020/09/01/c-9-0-records-work-with-immutable-data-classes/)
 - [Record Types in C# 9.0](https://lukemerrett.com/record-types-in-c-9-0/)
 - [Notes about C# records and Nullable Reference Types](https://event-driven.io/en/notes_about_csharp_records_and_nullable_reference_types/)
+- [Explicit validation in C# just got simpler!](https://event-driven.io/en/explicit_validation_in_csharp_just_got_simpler/)
 - [Introducing C# 10: Record struct](https://anthonygiretti.com/2021/08/03/introducing-c-10-record-struct/)
 - [ASP.NET Core 5 Model Binding to C# 9 Record Types](https://www.davidhayden.me/blog/asp-net-core-5-model-binding-to-csharp-9-record-types)
 - [Are C# 9 records immutable by default?](https://www.daveabrock.com/2020/11/02/csharp-9-records-immutable-default/)
 - [Using records when implementing the builder pattern in C#](https://josef.codes/using-records-when-implementing-the-builder-pattern-in-c-sharp/)
+- [Deconstructing a C# record with properties](https://alexanderzeitler.com/articles/deconstructing-a-csharp-record-with-properties/)
+
 ## 📺 Videos
 - [C# 9.0: Record types](https://www.youtube.com/watch?v=oSQDZ7GpKwg)
 - [What are record types in C# and how they ACTUALLY work](https://www.youtube.com/watch?v=9v6RENPk5iM)

diff --git a/docs/csharp/reflection.md b/docs/csharp/reflection.md
@@ -76,6 +76,7 @@
 - [Achieving compile-time performance with Reflection in C#](https://www.youtube.com/watch?v=er9nD-usM1A)
 - [Dynamically invoking a generic method with Reflection in .NET C#](https://www.youtube.com/watch?v=ZfS4WnITx08)
 - [C# Reflection Explained (Claim generation example)](https://www.youtube.com/watch?v=cdG2JxuZvNI)
+- [.NET IL Weaving Demo with Mono.Cecil](https://www.youtube.com/watch?v=L-RQmSPy7Qo)
 
 ## Tools
 - [Process Explorer](https://learn.microsoft.com/en-us/sysinternals/downloads/process-explorer)

diff --git a/docs/csharp/versions/12.md b/docs/csharp/versions/12.md
@@ -0,0 +1,4 @@
+# C# 12
+
+## Articles
+- [Check out new C# 12 preview features!](https://devblogs.microsoft.com/dotnet/check-out-csharp-12-preview/)
diff --git a/docs/dependency-injection.md b/docs/dependency-injection.md
@@ -59,7 +59,7 @@
 - [Captive Dependency with ASP.NET Core](https://medium.com/dotnet-hub/captive-dependency-with-asp-net-core-what-is-captive-dependency-8698b588e048)
 - [.NET Core and DI – Beware of Captive Dependency](https://ankitvijay.net/2020/03/17/net-core-and-di-beware-of-captive-dependency/)
 - [Top Misconceptions About Dependency Injection in ASP.NET Core](https://levelup.gitconnected.com/top-misconceptions-about-dependency-injection-in-asp-net-core-c6a7afd14eb4)
-- [Configure Dependency Injection for .NET 5 Console Applications](https://www.programmingwithwolfgang.com/configure-dependency-injection-for-net-5-console-application)
+- [Configure Dependency Injection for .NET 5 Console Applications](https://www.programmingwithwolfgang.com/configure-dependency-injection-for-net-5-console-applications/)
 - [New dependency injection features in .NET 6 ](https://andrewlock.net/exploring-dotnet-6-part-10-new-dependency-injection-features-in-dotnet-6/)
 - [Dependency Injection Lifetimes in ASP.NET Core](https://code-maze.com/dependency-injection-lifetimes-aspnet-core/)
 - [Advanced Dependency Injection Techniques in ASP.NET Core](https://medium.com/geekculture/advanced-dependency-injection-techniques-in-asp-net-core-3e6e9e0c541a)
@@ -76,6 +76,14 @@
 - [The dangers and gotchas of using scoped services in IConfigureOptions](https://andrewlock.net/the-dangers-and-gotchas-of-using-scoped-services-when-configuring-options-in-asp-net-core/)
 - [Injecting services into ValidationAttributes in ASP.NET Core](https://andrewlock.net/injecting-services-into-validationattributes-in-asp-net-core/)
 - [Structure and order your DI container](https://steven-giesel.com/blogPost/f557493c-0919-44fc-8073-40b4fb90d53e)
+- [Building a Console App with .NET Generic Host](https://dfederm.com/building-a-console-app-with-.net-generic-host/)
+- [How To Enable Logging In .NET Console Applications](https://thecodeblogger.com/2021/05/11/how-to-enable-logging-in-net-console-applications/)
+- [USING HOSTBUILDER AND THE GENERIC HOST IN .NET CORE MICROSERVICES](https://www.stevejgordon.co.uk/using-generic-host-in-dotnet-core-console-based-microservices)
+- [How to run .NET Core Console app using generic host builder](https://stackoverflow.com/questions/68392429/how-to-run-net-core-console-app-using-generic-host-builder)
+- [Verifying your DI Container](https://steven-giesel.com/blogPost/ce948083-974a-4c16-877f-246b8909fa6d)
+- [ASP.NET CORE DEPENDENCY INJECTION: WHAT IS THE ISERVICEPROVIDER AND HOW IS IT BUILT?](https://www.stevejgordon.co.uk/aspnet-core-dependency-injection-what-is-the-iserviceprovider-and-how-is-it-built) ⭐⭐
+- [Dependency injection guidelines](https://learn.microsoft.com/en-us/dotnet/core/extensions/dependency-injection-guidelines)
+
 ## 📺 Videos
 - [.NET Core Dependency Injection – The Booster Jab - Steve Collins - NDC London 2021](https://www.youtube.com/watch?v=JwVtscL9H9k)
 - [Dependency Injection Explained](https://www.youtube.com/watch?v=ASDmrUaO5cE)