chore: Update image source in introduction/exploring-docs/index.md

Author: giovanninocco

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

@@ -1,7 +1,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 for 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
 draft: false
@@ -16,7 +16,7 @@ toc: true
 ---
 Genocs Library's **.NET Templates** needs you to have the following *applications/tools* available on your machine. 
 
-Please Note that this project is being built on a Windows 11 Machine using Visual Studio Code IDE.
+Please Note that this project is being built on a Windows11 Machine using Visual Studio Code IDE.
 
 ## .NET SDK
 
@@ -51,10 +51,7 @@ Genocs Library's .NET Microservice Template gives you the freedom to choose betw
 
 {{< alert text="Make sure that you have at least one of these servers installed, along with a Database Management tool like Azure Data Studio / PostgreSQL pgAdmin / MySQL Workbench " />}}
 
-### PostgreSQL
 
-Probably the best Open Source Database Server with lots of Enterprise level features.
-- Download postgresql Installer - [Get from postgresql.org](https://www.postgresql.org/download/)
 
 ### MSSQL
 
@@ -73,6 +70,11 @@ There are high chances that you already have this installed on your machine. Thi
 
 - [Download](https://www.oracle.com/in/database/technologies/oracle19c-windows-downloads.html)
 
+### PostgreSQL
+
+Probably the best Open Source Database Server with lots of Enterprise level features.
+- Download postgresql Installer - [Get from postgresql.org](https://www.postgresql.org/download/)
+
 ## API Testing Tools
 
 ### POSTMAN

content/en/dotnet-templates/tutorials/NSwag/index.md

@@ -0,0 +1,51 @@
+---
+title: "How to use NSwag with Genocs Microservice Template"
+description: "Using NSwag with Genocs Microservice Template"
+lead: "Let's get started with using NSwag with Genocs Microservice Template"
+date: 2024-10-07T16:14:00+02:00
+lastmod: 2024-10-07T16:14:00+02:00
+draft: false
+images: []
+menu:
+  dotnet-templates:
+    identifier: "nswag"
+    name: "NSwag"
+    parent: "tutorials"
+weight: 12
+toc: true
+---
+
+Genocs Library's Blazor Template leverege the NSwag capabilities. This means that you can easily generate API Clients ease. This tutorial will guide you through the process of using NSwag with Genocs Library's Web API.
+
+
+## Prerequisites
+
+The template contains a script that will automatically generate the necessary files for you. However, you need to have the following components installed on your machine:
+
+```ps
+# Install the NSwag Build *Mandatory*
+dotnet tool install -g NSwag.MSBuild
+
+# Install the NSwag CLI *Optional*
+dotnet tool install -g NSwag.Console
+
+# Install the NSwag Code Generation *Optional*
+dotnet tool install -g NSwag.CodeGeneration
+```
+           
+
+Into the `scripts` folder you will find `nswag-regen.ps1`. This script will generate the necessary files for you. You can run the script by executing the following command:
+
+Before run be shure the API is running, you can run the API by executing the following command:
+
+```ps
+# Run your API locally
+dotnet run --project .\src\Genocs.MicroserviceTemplate.Api\Genocs.MicroserviceTemplate.Api.csproj
+```
+
+then run the script:
+```ps
+.\scripts\nswag-regen.ps1
+```
+
+The script will generate the necessary `src\Infrastructure\ApiClient\GNXApi.cs` file for you..

content/en/dotnet-templates/tutorials/database-migrations/index.md

@@ -1,7 +1,7 @@
 ---
 title: "Genocs Microservice Template along with Entity Framework Core"
-description: "Adding Database Migrations for Entity Framework Core with Genocs Library's Web API"
-lead: "Adding Database Migrations for Entity Framework Core with Genocs Library's Web API"
+description: "Adding Database Migrations for Entity Framework Core"
+lead: "Adding Database Migrations for Entity Framework Core"
 date: 2022-01-15T21:31:40+05:30
 lastmod: 2024-08-21 14:50:50+02:00
 draft: false
@@ -23,7 +23,13 @@ Before you begin, make sure you have the following installed on your machine:
 
 1. [.NET 8.0 SDK](https://dotnet.microsoft.com/download/dotnet/8.0)
 2. [Visual Studio Code](https://code.visualstudio.com/) or [Visual Studio 2019](https://visualstudio.microsoft.com/downloads/)
-3. [MySQL Server](https://dev.mysql.com/downloads/mysql/) or [MSSQL Server](https://www.microsoft.com/en-us/sql-server/sql-server-downloads) or [PostgreSQL Server](https://www.postgresql.org/download/) or [Oracle Server](https://www.oracle.com/database/technologies/)
+3. Database Server:
+
+    1. [MSSQL Server](https://www.microsoft.com/en-us/sql-server/sql-server-downloads)
+    2. [MySQL Server](https://dev.mysql.com/downloads/mysql/)
+    3. [Oracle Server](https://www.oracle.com/database/technologies/)
+    4. [PostgreSQL Server](https://www.postgresql.org/download/)
+    5. [SQLite Server](https://www.sqlite.org/download.html)     
 
 
 ## Create Database Migrations
@@ -62,7 +68,7 @@ Note that currently, Genocs Microservice Template supports the following major D
 4. PostgreSQL
 5. SQLite
 
-Download links to setup the supported Database providers are mentioned here - https://genocs-blog.netlify.app/dotnet-templates/general/development-environment/
+Here you can find everything to setup the supported Database providers - [Setup Databases](https://genocs-blog.netlify.app/dotnet-templates/general/development-environment/)
 
 To maintain scalability, the database migrations of each of these DB Providers are kept in separate class library projects namely
 1. Migrators/Migrators.MSSQL
@@ -74,6 +80,7 @@ To maintain scalability, the database migrations of each of these DB Providers a
 Out of the box, the default migrations are already generated and is made available for you. This means you wouldn't even have to run a `update-database` to get started. The Application startup already handles it for you.
 
 As of now, Genocs Library's Microservice Template consists of the following EF Core DB Context classes:
+
 1. **ApplicationDbContext** - This is where you would ideally reference your new entities. By default, Catalog entities are referenced here.
 2. **TenantDbContext** - Related to Finbuckle's Multitenancy setup of Stores.
 
@@ -91,16 +98,69 @@ Below are some sample configurations for MySQL Provider. The above is applicable
 
 #### database.json
 
+**mssql** 
+``` json
+{
+  "DatabaseSettings": {
+    "DBProvider": "mssql",
+    "ConnectionString": "Data Source=(localdb)\\mssqllocaldb;Initial Catalog=Genocs.Microservice.Template;Integrated Security=True;MultipleActiveResultSets=True"
+  }
+}
+```
+
+**mysql**
 ``` json
 {
-  "DatabaseSettings": { 
+  "DatabaseSettings": {
     "DBProvider": "mysql",
     "ConnectionString": "server=localhost;uid=root;pwd=root;database=defaultRootDb;Allow User Variables=True"
   }
 }
 ```
+
+**oracle**
+``` json
+{
+  "DatabaseSettings": {
+    "DBProvider": "oracle",
+    "ConnectionString": "Data Source=localhost;User Id=system;Password=oracle;"
+  }
+}
+```
+
+**postgresql**
+``` json
+{
+  "DatabaseSettings": {
+    "DBProvider": "postgresql",
+    "ConnectionString": "Host=localhost;Port=5432;Database=Genocs.Microservice.Template;Username=postgres;Password=postgres"
+  }
+}
+```
+
+**sqlite**
+``` json
+{
+  "DatabaseSettings": {
+    "DBProvider": "sqlite",
+    "ConnectionString": "Data Source=app.db;"
+  }
+}
+```
+
 #### hangfire.json
 
+**mssql**
+``` json
+{
+  "Storage": {
+    "StorageProvider": "mssql",
+    "ConnectionString": "Data Source=(localdb)\\mssqllocaldb;Initial Catalog=Genocs.Microservice.Template;Integrated Security=True;MultipleActiveResultSets=True"
+  }
+}
+```
+
+**mysql**
 ``` json
 {
   "Storage": {
@@ -110,6 +170,37 @@ Below are some sample configurations for MySQL Provider. The above is applicable
 }
 ```
 
+**oracle**
+``` json
+{
+  "Storage": {
+    "StorageProvider": "oracle",
+    "ConnectionString": "Data Source=localhost;User Id=system;Password=oracle;"
+  }
+}
+
+```
+
+**postgresql**
+``` json
+{
+  "Storage": {
+    "StorageProvider": "postgresql",
+    "ConnectionString": "Host=localhost;Port=5432;Database=Genocs.Microservice.Template;Username=postgres;Password=postgres"
+  }
+}
+```
+
+**sqlite**
+``` json
+{
+  "Storage": {
+    "StorageProvider": "sqlite",
+    "ConnectionString": "Data Source=app.db;"
+  }
+}
+```
+
 The Provider values for other supported DBs are as follows.
 - MSSQL - **mssql**
 - MYSQL - **mssql**
@@ -153,6 +244,8 @@ dotnet ef migrations add AddedMenuEntity --project ../Migrators/Migrators.MySQL/
 dotnet ef migrations add ModifiedTenantTable --project ../Migrators/Migrators.MySQL/ --context TenantDbContext -o Migrations/Tenant
 ```
 
-That's almost it. Once the process is completed you would be able see new Migration cs files that represent your new additions / modifications at the table level added to the respective Migrator project.
+That's almost it.
+
+Once the process is completed you would be able see new Migration cs files that represent your new `additions/modifications` at the table level added to the respective Migrator project.
 
 You do not have to do anything extra to apply the migrations to your database. The application does it for you during the startup.

content/en/introduction/contributing/index.md

@@ -3,7 +3,7 @@ title: "Contributing"
 description: "Contributing to Genocs Library"
 lead: "Contributing to Genocs Library"
 date: 2023-05-13T15:40:19+02:00
-lastmod: 2023-06-25T15:40:19+02:00
+lastmod: 2024-10-07T16:40:19+02:00
 draft: false
 images: []
 menu:
@@ -25,8 +25,8 @@ Currently, you can contribute to:
 - [Deployments](https://github.com/Genocs/enterprise-containers)
 - [Example](https://github.com/Genocs/genocs-basket)
 
-- [.NET Web API Template](https://github.com/Genocs/dotnet-webapi-template) (soon)
-- [Blazor WebAssembly Template](https://github.com/Genocs/blazor-template) (soon)
+- [.NET Web API Template](https://github.com/Genocs/microservice-template)
+- [Blazor WebAssembly Template](https://github.com/Genocs/blazor-template)
 - [Angular Front-End](https://github.com/Genocs/angular-frontend-template) (soon)
 - [React Front-End](https://github.com/Genocs/react-frontend-template) (soon)
 

content/en/introduction/exploring-docs/2024-10-07.png

@@ -17,4 +17,4 @@ toc: true
 
 <b>Genocs Library</b> sports a pretty much straight forward documentation website that is frequently updated and also accepts new documentations/corrections from the community!
 
-{{< img src="docs.png" >}}
+{{< img src="2024-10-07.png" >}}

content/en/introduction/exploring-docs/docs.png

@@ -14,3 +14,57 @@ menu:
 weight: 7
 toc: true
 ---
+
+
+This code snippet is used to send an email using SendGrid. The code snippet is written in C# and uses the SendGrid NuGet package. The code snippet is used to send an email to multiple recipients. The code snippet is written in C# and uses the SendGrid NuGet package. The code snippet is used to send an email to multiple recipients.
+
+```csharp
+
+    private async Task InternalSend(string subject, string content)
+    {
+        try
+        {
+            var client = new SendGridClient(_settings.ApiKey);
+            var from = new EmailAddress(_settings.Email);
+            var plainTextContent = "This email is generated by the system. Please do not respond on this account";
+
+            var recipients = _settings.Recipients.Split(",");
+            if (recipients.Length == 1)
+            {
+                var to = new EmailAddress(_settings.Recipients);
+                var msg = MailHelper.CreateSingleEmail(from,
+                                                    to,
+                                                    subject,
+                                                    plainTextContent,
+                                                    content);
+                var response = await client.SendEmailAsync(msg);
+                var res = response.IsSuccessStatusCode;
+            }
+            else
+            {
+                var recipientsAddress = new List<EmailAddress>();
+                foreach (string recipient in recipients)
+                {
+                    if (!string.IsNullOrWhiteSpace(recipient))
+                    {
+                        recipientsAddress.Add(new EmailAddress(recipient.Trim()));
+                    }
+                }
+
+                var to = new EmailAddress(_settings.Recipients);
+                var msg = MailHelper.CreateSingleEmailToMultipleRecipients(from,
+                                                    recipientsAddress,
+                                                    subject,
+                                                    plainTextContent,
+                                                    content);
+
+                var response = await client.SendEmailAsync(msg);
+                var res = response.IsSuccessStatusCode;
+            }
+        }
+        catch (System.Exception ex)
+        {
+            _logger.LogError("Error on Send Email", ex);
+        }
+    }
+```