From 0ac30c0ec04bd06c394cf7cf21d3bd4e691d3eb0 Mon Sep 17 00:00:00 2001 From: Mehdi Hadeli Date: Sat, 6 Apr 2024 21:27:09 +0330 Subject: [PATCH 1/2] docs: add some new links --- docs/ai.md | 3 ++- docs/devops/terminal/bash.md | 1 + docs/devops/terminal/powershell.md | 4 ++++ docs/grpc.md | 2 ++ docs/microservices/tools/aspire.md | 1 + docs/microservices/tools/mass-transit.md | 5 +++++ docs/microservices/tools/wolverine.md | 5 ++++- mkdocs.yml | 3 +++ 8 files changed, 22 insertions(+), 2 deletions(-) create mode 100644 docs/devops/terminal/bash.md create mode 100644 docs/devops/terminal/powershell.md diff --git a/docs/ai.md b/docs/ai.md index 1e7ed09b7..de76b440f 100644 --- a/docs/ai.md +++ b/docs/ai.md @@ -36,7 +36,6 @@ - [nomic-ai/gpt4all](https://github.com/nomic-ai/gpt4all) - gpt4all: a chatbot trained on a massive collection of clean assistant data including code, stories and dialogue - [Torantulino/Auto-GPT](https://github.com/Torantulino/Auto-GPT) - An experimental open-source attempt to make GPT-4 fully autonomous. - [microsoft/DeepSpeed](https://github.com/microsoft/DeepSpeed) - DeepSpeed is a deep learning optimization library that makes distributed training and inference easy, efficient, and effective. -- [hwchase17/langchain](https://github.com/hwchase17/langchain) - Building applications with LLMs through composability ⚡ - [cfortuner/promptable](https://github.com/cfortuner/promptable) - Build LLM apps in Typescript/Javascript. - [lm-sys/FastChat](https://github.com/lm-sys/FastChat) - The release repo for "Vicuna: An Open Chatbot Impressing GPT-4" - [karpathy/nanoGPT](https://github.com/karpathy/nanoGPT) - The simplest, fastest repository for training/finetuning medium-sized GPTs. @@ -68,6 +67,8 @@ - [LAION-AI/Open-Assistant](https://github.com/LAION-AI/Open-Assistant) - OpenAssistant is a chat-based assistant that understands tasks, can interact with third-party systems, and retrieve information dynamically to do so. - [tmc/langchaingo](https://github.com/tmc/langchaingo) - LangChain for Go, the easiest way to write LLM-based programs in Go - [abi/screenshot-to-code](https://github.com/abi/screenshot-to-code) - Drop in a screenshot and convert it to clean HTML/Tailwind/JS code +- [janhq/jan](https://github.com/janhq/jan) - Jan is an open source alternative to ChatGPT that runs 100% offline on your computer +- [langchain-ai/langchain](https://github.com/langchain-ai/langchain) ⭐ - Build context-aware reasoning applications ## Samples - [Azure-Samples/openai-dotnet-samples](https://github.com/Azure-Samples/openai-dotnet-samples) diff --git a/docs/devops/terminal/bash.md b/docs/devops/terminal/bash.md new file mode 100644 index 000000000..1af8b2c16 --- /dev/null +++ b/docs/devops/terminal/bash.md @@ -0,0 +1 @@ +# Bash \ No newline at end of file diff --git a/docs/devops/terminal/powershell.md b/docs/devops/terminal/powershell.md new file mode 100644 index 000000000..2a73edbac --- /dev/null +++ b/docs/devops/terminal/powershell.md @@ -0,0 +1,4 @@ +# Powershell + +## Resources +- [PowerShell Cheat Sheet / Quick Reference](https://gist.github.com/pcgeek86/336e08d1a09e3dd1a8f0a30a9fe61c8a) \ No newline at end of file diff --git a/docs/grpc.md b/docs/grpc.md index 8f4afd613..72cffa9e3 100644 --- a/docs/grpc.md +++ b/docs/grpc.md @@ -87,6 +87,8 @@ - [Cysharp/MagicOnion](https://github.com/Cysharp/MagicOnion) - Unified Realtime/API framework for .NET platform and Unity. - [AnthonyGiretti/grpc-aspnetcore-validator](https://github.com/AnthonyGiretti/grpc-aspnetcore-validator) - Simple request message validator for grpc.aspnetcore - [grpc-ecosystem/grpc-gateway](https://github.com/grpc-ecosystem/grpc-gateway) - gRPC to JSON proxy generator following the gRPC HTTP spec +- [bufbuild/buf](https://github.com/bufbuild/buf) - A new way of working with Protocol Buffers. + ## 🚀 Samples - [aspnetrun/run-aspnet-grpc](https://github.com/aspnetrun/run-aspnet-grpc) - Using gRPC in Microservices for Building a high-performance Interservice Communication with .Net 5. See gRPC Microservices and Step by Step Implementation on .NET Course w/ discount diff --git a/docs/microservices/tools/aspire.md b/docs/microservices/tools/aspire.md index 0eb85e45c..c32d70e49 100644 --- a/docs/microservices/tools/aspire.md +++ b/docs/microservices/tools/aspire.md @@ -4,6 +4,7 @@ - [Introducing .NET Aspire: Simplifying Cloud-Native Development with .NET 8](https://devblogs.microsoft.com/dotnet/introducing-dotnet-aspire-simplifying-cloud-native-development-with-dotnet-8/) - [Announcing .NET Aspire Preview 2](https://devblogs.microsoft.com/dotnet/announcing-dotnet-aspire-preview-2/) - [Why I won't use .NET Aspire for now](https://event-driven.io/en/nay_to_aspire/) +- [Transactional Outbox in .NET Cloud Native Development via Aspire](https://nikiforovall.github.io/dotnet/aspnetcore/aspire/2024/03/30/aspire-cap.html) ## Videos - [Building Cloud Native apps with .NET 8 | .NET Conf 2023](https://www.youtube.com/watch?v=z1M-7Bms1Jg) diff --git a/docs/microservices/tools/mass-transit.md b/docs/microservices/tools/mass-transit.md index bddf04e47..288b12c1f 100644 --- a/docs/microservices/tools/mass-transit.md +++ b/docs/microservices/tools/mass-transit.md @@ -24,6 +24,9 @@ - [ASP.NET Correlation ID](https://markgossa.com/2022/05/asp-net-correlation-id.html) - [Error Handling and Message Redelivery in MassTransit](https://www.gokhan-gokalp.com/en/messaging-yapilarinda-masstransit-ile-error-ve-redeliver-handling/) - [Building a More Useful Outbox for Reliable Messaging](https://jeremydmiller.com/2022/06/16/building-a-more-useful-outbox-for-reliable-messaging/) +- [MassTransit Testing](https://masstransit.io/documentation/concepts/testing) +- [MassTransit observability](https://masstransit.io/documentation/configuration/observability) +- [A better Masstransit Test harness](https://andersmalmgren.com/2022/08/17/a-better-masstransit-test-harness/) ## 📺 Videos - [MassTransit–Youtube videos](https://bartwullems.blogspot.com/2020/07/masstransityoutube-videos.html) @@ -44,7 +47,9 @@ - [MassTransit Exception Handling, Retry Middleware](https://www.youtube.com/watch?v=f1Oa65U2OeQ) - [Build Clean Messaging in .NET with MassTransit](https://www.youtube.com/watch?v=4FFYefcx4Bg) - [MassTransit - The New Transactional Outbox](https://www.youtube.com/watch?v=3TjGnmLno_A) +- [MassTransit v8 - Open Telemetry](https://www.youtube.com/watch?v=WsTYClGrOVI) - [OSS Power-Ups: MassTransit](https://www.youtube.com/watch?v=sbt9p7jqe74) +- [TestHarnes and OpenTelemetry](https://youtu.be/7PM9XUAAMtA) ## 📦 Libraries - [GokGokalp/MetroBus](https://github.com/GokGokalp/MetroBus) - Lightweight messaging wrapper of MassTransit diff --git a/docs/microservices/tools/wolverine.md b/docs/microservices/tools/wolverine.md index cf07c8c79..ee2025a4a 100644 --- a/docs/microservices/tools/wolverine.md +++ b/docs/microservices/tools/wolverine.md @@ -11,7 +11,7 @@ - [Wolverine embraces Observability](https://timdeschryver.dev/blog/wolverine-embraces-observability) - [Messages and Serialization](https://wolverine.netlify.app/guide/messages.html) - [ASP.Net Core Integration](https://wolverine.netlify.app/guide/http/integration.html) -- [Using Local Queueing](https://wolverine.netlify.app/guide/messaging/transports/local.html +- [Using Local Queueing](https://wolverine.netlify.app/guide/messaging/transports/local.html) - [Building a Critter Stack Application: Event Storming](https://jeremydmiller.com/2023/11/28/building-a-critter-stack-application-event-storming/) - [Building a Critter Stack Application: Marten as Event Store](https://jeremydmiller.com/2023/11/29/building-a-critter-stack-application-marten-as-event-store/) - [Building a Critter Stack Application: Marten Projections](https://jeremydmiller.com/2023/11/30/building-a-critter-stack-application-marten-projections/) @@ -25,6 +25,9 @@ - [Building a Critter Stack Application: Durable Outbox Messaging and Why You Care!](https://jeremydmiller.com/2023/12/28/building-a-critter-stack-application-durable-outbox-messaging-and-why-you-care/) - [Building a Critter Stack Application: Wolverine HTTP Endpoints](https://jeremydmiller.com/2024/01/09/building-a-critter-stack-application-wolverine-http-endpoints/) - [Building a Critter Stack Application: Easy Unit Testing with Pure Functions](https://jeremydmiller.com/2024/01/10/building-a-critter-stack-application-easy-unit-testing-with-pure-functions/) +- [Wolverine’s Baked In Integration Testing Support](https://jeremydmiller.com/2024/03/25/wolverines-baked-in-integration-testing-support/) +- [Testing Asynchronous Projections in Marten](https://jeremydmiller.com/2024/03/26/testing-asynchronous-projections-in-marten/) + ## Vidoes - [Don't let MediatR hold you back, try this...](https://www.youtube.com/watch?v=YlG3bnJ7yCc) - [CQRS with Event Sourcing using the “Critter Stack” | .NET Conf 2023](https://www.youtube.com/watch?v=KousO1UsHYM) diff --git a/mkdocs.yml b/mkdocs.yml index c01499fb2..b47e2859f 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -202,6 +202,9 @@ nav: - Telepresence: devops/kubernetes/other-tools/telepresence.md - Garden: devops/kubernetes/other-tools/garden.md - Tilt: devops/kubernetes/other-tools/tilt.md + - Terminal: + - Bash: devops/terminal/bash.md + - Powershell: devops/terminal/powershell.md - Distributed Locking: distributed-locking.md - Distributed Transactions & Saga: distributed-transactions.md - Domain Driven Design: From 665e2d0a28f8a0d55a1668e1033a017fb0829937 Mon Sep 17 00:00:00 2001 From: Mehdi Hadeli Date: Thu, 11 Apr 2024 00:17:06 +0330 Subject: [PATCH 2/2] docs: add some new links --- docs/concurrency.md | 1 + docs/domain-driven-design/exception-and-validation.md | 2 +- docs/microservices/tools/aspire.md | 4 ++++ docs/modular-monolith.md | 2 ++ docs/vertical-slice-architecture.md | 3 ++- 5 files changed, 10 insertions(+), 2 deletions(-) diff --git a/docs/concurrency.md b/docs/concurrency.md index 17562aad9..82d3d9f29 100644 --- a/docs/concurrency.md +++ b/docs/concurrency.md @@ -30,6 +30,7 @@ - [Optimistic Concurrency in an HTTP API with ETags & Hypermedia](https://codeopinion.com/optimistic-concurrency-in-an-http-api-with-etags-hypermedia/) - [HTTP and ETag Header Fields](https://blog.peterritchie.com/posts/http-and-etag-header-fields) ⭐ - [ETags in ASP.NET Core](https://blog.peterritchie.com/posts/etags-in-aspdotnet-core) ⭐ +- [Be optimistic about concurrency in Entity Framework](https://www.dateo-software.de/blog/concurrency-entity-framework) # Videos - [Optimistic Concurrency in an HTTP API with ETags & Hypermedia](https://www.youtube.com/watch?v=2Nk3kCCyu3A) diff --git a/docs/domain-driven-design/exception-and-validation.md b/docs/domain-driven-design/exception-and-validation.md index 86315dab9..a9d21d008 100644 --- a/docs/domain-driven-design/exception-and-validation.md +++ b/docs/domain-driven-design/exception-and-validation.md @@ -36,7 +36,7 @@ - [How to validate business logic](https://event-driven.io/en/how_to_validate_business_logic/) ⭐ - [Explicit validation in C# just got simpler!](https://event-driven.io/en/explicit_validation_in_csharp_just_got_simpler/) ⭐ - [Notes about C# records and Nullable Reference Types](https://event-driven.io/en/notes_about_csharp_records_and_nullable_reference_types/) ⭐ - +- [Exploring Advanced Error Handling Patterns with Event Driven Architecture Part I](https://medium.com/ssense-tech/exploring-advanced-error-handling-patterns-with-event-driven-architecture-part-i-e2f37741d904) ## 📦 Libraries - [ardalis/GuardClauses](https://github.com/ardalis/GuardClauses) - A simple package with guard clause extensions. - [danielwertheim/Ensure.That](https://github.com/danielwertheim/Ensure.That) - Guard clause project for .NET diff --git a/docs/microservices/tools/aspire.md b/docs/microservices/tools/aspire.md index c32d70e49..d0f7985c5 100644 --- a/docs/microservices/tools/aspire.md +++ b/docs/microservices/tools/aspire.md @@ -1,8 +1,12 @@ # Aspire ## Articles +- [.NET Aspire overview](https://learn.microsoft.com/en-us/dotnet/aspire/get-started/aspire-overview) - [Introducing .NET Aspire: Simplifying Cloud-Native Development with .NET 8](https://devblogs.microsoft.com/dotnet/introducing-dotnet-aspire-simplifying-cloud-native-development-with-dotnet-8/) - [Announcing .NET Aspire Preview 2](https://devblogs.microsoft.com/dotnet/announcing-dotnet-aspire-preview-2/) +- [.NET Aspire preview 3](https://learn.microsoft.com/en-us/dotnet/aspire/whats-new/preview-3) +- [.NET Aspire preview 4](https://learn.microsoft.com/en-us/dotnet/aspire/whats-new/preview-4) +- [.NET Aspire preview 5](https://learn.microsoft.com/en-us/dotnet/aspire/whats-new/preview-5) - [Why I won't use .NET Aspire for now](https://event-driven.io/en/nay_to_aspire/) - [Transactional Outbox in .NET Cloud Native Development via Aspire](https://nikiforovall.github.io/dotnet/aspnetcore/aspire/2024/03/30/aspire-cap.html) diff --git a/docs/modular-monolith.md b/docs/modular-monolith.md index dbfceff86..d0b050c82 100644 --- a/docs/modular-monolith.md +++ b/docs/modular-monolith.md @@ -38,6 +38,8 @@ - [Easy Modular Monolith — Part 5— JWT Authentication/Authorization](https://itnext.io/easy-modular-monolith-part-5-jwt-authentication-authorization-f7a0a275226f) - [Easy Modular Monolith — Part 6 — Synchronous communication between modules](https://itnext.io/easy-modular-monolith-part-5-synchronous-communication-between-modules-7af876f06c16) - [Build the modular monolith first](https://www.fearofoblivion.com/build-a-modular-monolith-first) +- [Thoughts on “Modular Monoliths”](https://jeremydmiller.com/2024/04/01/thoughts-on-modular-monoliths/) +- [Actually Talking about Modular Monoliths](https://jeremydmiller.com/2024/04/08/actually-talking-about-modular-monoliths/) ## 📺 Videos - [GOTO 2018 • Modular Monoliths • Simon Brown](https://www.youtube.com/watch?v=5OjqD-ow8GE) diff --git a/docs/vertical-slice-architecture.md b/docs/vertical-slice-architecture.md index b499c868a..2113d468f 100644 --- a/docs/vertical-slice-architecture.md +++ b/docs/vertical-slice-architecture.md @@ -52,8 +52,9 @@ - [Vertical Software Development](https://medium.com/ssense-tech/vertical-software-development-495b73f7fcdf) - [Vertical Slices in practice](https://event-driven.io/en/-vertical_slices_in_practice/) ⭐ - [Low Ceremony Vertical Slice Architecture with Wolverine](https://jeremydmiller.com/2023/07/10/low-ceremony-vertical-slice-architecture-with-wolverine/) -[Compiled Queries with Marten](https://jeremydmiller.com/2023/07/12/compiled-queries-with-marten/) +- [Compiled Queries with Marten](https://jeremydmiller.com/2023/07/12/compiled-queries-with-marten/) - [Vertical Slice Architecture in ASP.NET Core](https://blog.ndepend.com/vertical-slice-architecture-in-asp-net-core/) ⭐ +- [There is no template for vertical slicing](https://www.dateo-software.de/blog/no-vertical-slicing-template) ## 📺 Videos - [SOLID Architecture in Slices not Layers - Jimmy Bogard](https://vimeo.com/131633177)