chore: Update documentation for .NET 9.0 release, including Docker commands and SDK references

Author: giovanninocco

README.md

@@ -38,7 +38,10 @@ docker run -d -p 1313:80 genocs/genocs-library-docs
 5. push the image to docker hub
 ```bash
 docker login
+docker tag genocs/genocs-library-docs genocs/genocs-library-docs:1.0.0
 docker tag genocs/genocs-library-docs genocs/genocs-library-docs:latest
+
+docker push genocs/genocs-library-docs:1.0.0
 docker push genocs/genocs-library-docs:latest
 ```
 

config/_default/params.toml

@@ -69,7 +69,7 @@ copyRight = "Copyright (c) 2024 Genocs"
 # Alert
 alert = true
 alertDismissable = false
-alertText = ".NET8 Genocs Library Released <a target=\"_blank\" class=\"alert-link\" href=\"https://www.youtube.com/watch?v=TgxDvU---Ak/\">Click here to get started!</a>"
+alertText = ".NET 9.0 Genocs Library Released <a target=\"_blank\" class=\"alert-link\" href=\"https://www.youtube.com/watch?v=TgxDvU---Ak/\">Click here to get started!</a>"
 
 # Edit Page
 repoHost = "GitHub"

content/en/blazor-template/general/development-environment.md

@@ -3,7 +3,7 @@ title: "Development Environment"
 description: "Setting up the Development Environment for the Blazor WebAssembly Template"
 lead: "Let's get started with setting up the Development Environment for Blazor WebAssembly Template Development!"
 date: 2023-05-13T15:40:19+02:00
-lastmod: 2024-02-29T19:44:00+02:00
+lastmod: 2024-11-24T00:00:00+02:00
 draft: false
 images: []
 menu:
@@ -18,11 +18,11 @@ Genocs Library's **Blazor WebAssembly Template** Project Development needs you t
 
 ## .NET SDK
 
-As mentioned earlier, this project is built with the latest available .NET SDK, which is .NET 8.0.
+As mentioned earlier, this project is built with the latest available .NET SDK, which is .NET 9.0.
 
 Ensure that you have the latest version of the SDK available - [Download from Microsoft](https://dotnet.microsoft.com/download/dotnet/8.0)
 
-{{< alert icon="💡" text="Note : At the time of compiling this documentation, the latest version available was SDK 8.0.201" />}}
+{{< alert icon="💡" text="Note : At the time of compiling this documentation, the latest version available was SDK 9.0.101" />}}
 
 
 ## IDE

content/en/blazor-template/general/overview.md

@@ -1,9 +1,9 @@
 ---
 title: "Overview"
-description: "Built with .NET 8 and MudBlazor Component Library. Incorporates the most essential Packages your projects will ever need. Follows Clean Architecture Principles."
-lead: "Built with .NET 8 and MudBlazor Component Library. Incorporates the most essential Packages your projects will ever need. Follows Clean Architecture Principles."
+description: "Built with .NET 9 and MudBlazor Component Library. Incorporates the most essential Packages your projects will ever need. Follows Clean Architecture Principles."
+lead: "Built with .NET 9 and MudBlazor Component Library. Incorporates the most essential Packages your projects will ever need. Follows Clean Architecture Principles."
 date: 2023-05-13T15:40:19+02:00
-lastmod: 2024-02-29T19:44:19+02:00
+lastmod: 2024-11-24T00:00:00+02:00
 draft: false
 images: []
 menu:
@@ -21,12 +21,12 @@ toc: true
 The goal of this repository is to help developers / companies kickstart their Web Application Development with a pre-built Blazor WebAssembly Template that includes several much needed components and features.
 
 > Note that this is a frontend / client application only! The backend for this application is available in a separate repository.
-> - Find Genocs Library's .NET 8 Web API Template here - https://github.com/Genocs/templates
+> - Find Genocs Library's .NET 9.0 Web API Template here - https://github.com/Genocs/templates
 
 ## Prerequisites
 
 - Make sure you have the API Running. Here is Genocs API Backend - https://github.com/Genocs/templates
-- Once Genocs Library's .NET 8 Web API is up and running, run the Blazor WebAssembly Project to consume it's services.
+- Once Genocs Library's .NET 9.0 Web API is up and running, run the Blazor WebAssembly Project to consume it's services.
 
 ## Community
 

content/en/introduction/getting-started/index.md

@@ -3,7 +3,7 @@ title: "Getting Started"
 description: "Let's get started with Genocs Library!"
 lead: "Let's get started with Genocs Library!"
 date: 2023-05-13T15:40:19+02:00
-lastmod: 2024-11-16T00:00:00+02:00
+lastmod: 2024-11-24T00:00:00+02:00
 draft: false
 images: []
 menu:
@@ -39,7 +39,7 @@ As the name suggests, the idea is to provide a full-stack end to end solution to
 
 <b>Genocs Library</b> should be the one-stop that caters to the needs of various developers in various technology. This obviously would require a lot of community adaptation and contributions.
 
-As for the initial releases, <b>Genocs Library</b> sports an API Project built on Microsoft's newest .NET 8 and the front-end application (that consumes the .NET 8 Web API) built with Blazor WebAssembly!
+As for the initial releases, <b>Genocs Library</b> sports an API Project built on Microsoft's newest .NET 9.0 and the front-end application (that consumes the .NET 9 Web API) built with Blazor WebAssembly!
 
 ## Projects
 
@@ -49,7 +49,7 @@ As for the initial releases, <b>Genocs Library</b> sports an API Project built o
     <div class="row justify-content-center text-center" style="padding:10px!important">
       <div class="card feature-card" style="padding:0px!important">
         <div style="padding:20px">
-          <h2 class="h4">.NET 8 Microservice Template</h2>
+          <h2 class="h4">.NET 9.0 Microservice Template</h2>
           <div class="tablet-group">
               <div class="tablet">web api</div>
               <div class="tablet tablet-secondary">.NET</div>
@@ -61,13 +61,13 @@ As for the initial releases, <b>Genocs Library</b> sports an API Project built o
       </div>
       <div class="card feature-card" style="padding:0px!important">
         <div style="padding:20px">
-          <h2 class="h4">.NET 8 Web API Template</h2>
+          <h2 class="h4">.NET 9.0 Web API Template</h2>
           <div class="tablet-group">
               <div class="tablet">web api</div>
               <div class="tablet tablet-secondary">.NET</div>
               <div class="tablet">multitenancy</div>
             </div>
-          <p>Getting to work with the latest and greatest of Microsoft's .NET 8 Web API fused with the goodness of Genocs Library.</p>
+          <p>Getting to work with the latest and greatest of Microsoft's .NET 9.0 Web API fused with the goodness of Genocs Library.</p>
           <p><a href="https://github.com/Genocs/templates">View Github Repository</a> | <a href="https://genocs-blog.netlify.app/templates/general/getting-started/">Read Getting Started Guide</a></p>
         </div>
       </div>
@@ -80,7 +80,7 @@ As for the initial releases, <b>Genocs Library</b> sports an API Project built o
               <div class="tablet tablet-secondary">blazor webassembly</div>
               <div class="tablet">multitenancy</div>
             </div>
-          <p>Clean Architecture Template Template for .NET 8.0 Blazor WebAssembly built for Genocs-Api WebAPI with MudBlazor Components.</p>
+          <p>Clean Architecture Template Template for .NET 9.0 Blazor WebAssembly built for Genocs-Api WebAPI with MudBlazor Components.</p>
           <p><a href="https://github.com/Genocs/genocs-library-docs">View Github Repository</a> | <a href="https://genocs-blog.netlify.app/blazor-template/general/overview/">Read Getting Started Guide</a></p>
         </div>
       </div>

content/en/library/builder/index.md

@@ -43,6 +43,25 @@ services.AddGenocs(builder.Configuration);
 ```
 
 
+> NOTE: By Adding `AddGenocs(builder.Configuration)` you are adding the following services:
+
+// Add health checks
+services.AddHealthChecks();
+
+No need to call MapHealthChecks, it is already done for you.
+
+
+```csharp
+// Map the Default Endpoints
+// It contains the following endpoints:
+// - /
+// - /health
+// - /live
+app.MapDefaultEndpoints();
+```
+
+
+
 ## Example
 
 This is an example of how to setup the builder in the `Program.cs` file along with some other services.
@@ -90,9 +109,6 @@ services.AddControllers().AddJsonOptions(x =>
     x.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter());
 });
 
-// Add health checks
-services.AddHealthChecks();
-
 
 var settings = new SecretSettings();
 builder.Configuration.GetSection(SecretSettings.Position).Bind(settings);
@@ -137,8 +153,7 @@ app.UseAuthorization();
 
 app.MapControllers();
 
-// Map the health checks
-app.MapHealthChecks("/hc");
+app.MapDefaultEndpoints();
 
 // Run the application
 app.Run();
@@ -154,13 +169,18 @@ Log.CloseAndFlush();
 
 ## Options
 
-- `name` - The service name.
-- `service` - Service name used TBW.
-- `instance` - The service instance.
-- `version` - The service version.
+- `name` - The service name. The service name is used to display the banner and the version is used to display the version of the service.
+- `service` - Service property is used to identify the service. This is used to identify the service in the logs. It *mandatory* to have this property when using the **OpenTelemetry** support.  
+- `instance` - The service instance. If present then the instance is used to setup **OpenTelemetry**.
+- `version` - The service version. If present then the version is used to setup **OpenTelemetry**.
 - `displayBanner` - If true then the banner is shown into the console.
 - `displayVersion` - If true then the service version is shown into the console. See `version` param.
 
+
+The service name is used to display the banner and the version is used to display the version of the service.
+
+```csharp
+
 ## Settings
 
 Use the following settings in the `appsettings.json` file according to your needs.

content/en/templates/general/development-environment.md

@@ -3,7 +3,7 @@ title: "Development Environment"
 description: "Setting up the Development Environment for the Genocs .NET Templates"
 lead: "Let's get started with setting up the Development Environment"
 date: 2023-05-13T15:51:03+02:00
-lastmod: 2024-08-21 14:50:50+02:00
+lastmod: 2024-11-24T00:00:00+02:00
 draft: false
 images: []
 menu:
@@ -20,11 +20,11 @@ Please Note that this project is being built on a Windows11 Machine using Visual
 
 ## .NET SDK
 
-As mentioned earlier, this project is built with the latest available .NET SDK, which is .NET 8.0.
+As mentioned earlier, this project is built with the latest available .NET SDK, which is .NET 9.0.
 
 Ensure that you have the latest version of the SDK available - [Download from Microsoft](https://dotnet.microsoft.com/download/dotnet/8.0)
 
-{{< alert icon="💡" text="Note : At the time of compiling this documentation, the latest version available was SDK 8.0.201" />}}
+{{< alert icon="💡" text="Note : At the time of compiling this documentation, the latest version available was SDK 9.0.101" />}}
 
 
 ## IDE

content/en/templates/general/getting-started/index.md

@@ -35,7 +35,7 @@ To get started with this Template, here are the available options.
 
 Before creating your first Genocs Library solution, you should ensure that your local machine has:
 
-- **.NET 8** You can find the download [here](https://dotnet.microsoft.com/en-us/download/dotnet/8.0).
+- **.NET 9.0** You can find the download [here](https://dotnet.microsoft.com/en-us/download/dotnet/9.0).
 - **NodeJS (16+)** You can find the download [here](https://nodejs.org/en/download).
 
 ### Installation

content/en/templates/general/makefile-commands.md

@@ -3,7 +3,7 @@ title: "MakeFile Commands"
 description: "Here are some important MakeFile Commands that are to be used along with Genocs Library CLI."
 lead: "Here are some important MakeFile Commands that are to be used along with Genocs Library CLI."
 date: 2023-05-13 10:23:13+02:00
-lastmod: 2024-08-21 14:50:50+02:00
+lastmod: 2024-11-24T00:00:00+02:00
 draft: false
 images: []
 menu:
@@ -44,7 +44,7 @@ This packs your Solution into a nuget package. The required .template.config fol
 ``` bash
 make publish
 ```
-Using .NET 8's Built-In Containerization feature, this command builds the docker image for you using the `dotnet publish` command internally. Here is how to setup the metadata of your docker image.
+Using .NET 9.0's Built-In Containerization feature, this command builds the docker image for you using the `dotnet publish` command internally. Here is how to setup the metadata of your docker image.
 
 Navigate to src/Host/Host.csproj file and modify the following as per your requirement.
 

content/en/templates/general/overview.md

@@ -1,9 +1,9 @@
 ---
 title: "Overview"
-description: "Genocs Library built with .NET8. Incorporates the most essential Packages your projects will ever need. Follows Clean Architecture Principles."
-lead: "Genocs Library built with .NET8. Incorporates the most essential Packages your projects will ever need. Follows Clean Architecture Principles."
+description: "Genocs Library built with .NET 9.0. Incorporates the most essential Packages your projects will ever need. Follows Clean Architecture Principles."
+lead: "Genocs Library built with .NET 9.0. Incorporates the most essential Packages your projects will ever need. Follows Clean Architecture Principles."
 date: 2023-05-13 09:17:27+02:00
-lastmod: 2024-08-21 14:50:50+02:00
+lastmod: 2024-11-24T00:00:00+02:00
 draft: false
 images: []
 menu:
@@ -22,11 +22,11 @@ Genocs Library is a starting point for your next `.NET Microservices library` th
 
 ## Goals
 
-The goal of this repository is to provide a complete and feature-rich starting point for any .NET Developer / Team to kick-start their next major project using .NET 8 microservice cloud agnostic solution. This also serves the purpose of learning advanced concepts and implementations such as `Multitenancy, CQRS, Onion Architecture, Clean Coding standards, Cloud Deployments with Terraform to AWS, Docker Concepts, CICD Pipelines & Workflows` and so on.
+The goal of this repository is to provide a complete and feature-rich starting point for any .NET Developer / Team to kick-start their next major project using .NET 9.0 microservice cloud agnostic solution. This also serves the purpose of learning advanced concepts and implementations such as `Multitenancy, CQRS, Onion Architecture, Clean Coding standards, Cloud Deployments with Terraform to AWS, Docker Concepts, CICD Pipelines & Workflows` and so on.
 
 ## Features
 
-- [x] Built on .NET8
+- [x] Built on .NET 9.0
 - [x] Follows Clean Architecture Principles
 - [x] Domain Driven Design
 - [x] Cloud Ready. Can be deployed to AWS Infrastructure as ECS Containers using Terraform!
@@ -84,7 +84,7 @@ To get started with this Template, here are the available options.
 
 Before creating your first solution, you should ensure that your local machine has:
 
-- **.NET 8** You can find the download [here](https://dotnet.microsoft.com/en-us/download/dotnet/8.0).
+- **.NET 9.0** You can find the download [here](https://dotnet.microsoft.com/en-us/download/dotnet/9.0).
 - **NodeJS (16+)** You can find the download [here](https://nodejs.org/en/download).
 
 #### Installation
@@ -115,7 +115,7 @@ OR
 genocs api n Genocs.Starter
 ```
 
-This will create a new .NET 8 WebAPI solution for you using the Genocs Templates.
+This will create a new .NET 9.0 WebAPI solution for you using the Genocs Templates.
 For further steps and details, [Read the Getting Started Guide](https://genocs-blog.netlify.app/templates/general/getting-started/)
 
 #### Update
@@ -206,7 +206,7 @@ For further steps and details, [Read the Getting Started Guide](https://genocs-b
 
 ## Containerization
 
-The API project, being .NET 8, it is configured to have built-in support for containerization. That means, you really don't need a Dockerfile to containerize the webapi.
+The API project, being .NET 9.0, it is configured to have built-in support for containerization. That means, you really don't need a Dockerfile to containerize the webapi.
 
 To build a docker image, all you have to do is, ensure that docker-desktop or docker instance is running. And run the following command at the root of the solution.