chore: Update last modified dates in documentation and improve formatting for code blocks

Author: giovanninocco

content/en/library/authentication/index.md

@@ -3,7 +3,7 @@ title : "Authentication - JWT"
 description: "Adds the integration with JWT using an available authentication middleware and system components to validate and grant the access tokens."
 lead: ""
 date: 2023-05-13T15:40:19+02:00
-lastmod: 2023-06-25T15:40:19+02:00
+lastmod: 2024-11-17T00:00:00+02:00
 draft: false
 images: []
 menu:
@@ -32,13 +32,13 @@ There are three different ways you can to create the access tokens:
 
 - Using a certificate.
 - Using a secret key.
-- Using a OpenId external provider.
+- Using an OpenId external provider.
 
-Using a certificate is the most secure way to create the access tokens. The certificate can be stored in the file system or in the Azure Key Vault.
+**Using a certificate** is the most secure way to create the access tokens. The certificate can be stored in the file system or in the Azure Key Vault.
 
-Using a secret key is the simplest way to create the access tokens. The secret key is stored in the appsettings.json file.
+**Using a secret** key is the simplest way to create the access tokens. The secret key is stored in the appsettings.json file.
 
-Using a OpenId external provider is the most flexible way to create the access tokens. The OpenId provider can be configured in the appsettings.json file.
+**Using an OpenId external provider** is the most flexible way to create the access tokens. The OpenId provider can be configured in the `appsettings.json` file.
 
 ## JWT authentication with CERTIFICATE
 
@@ -161,31 +161,22 @@ To blacklist and deactivate the access tokens, use `IAccessTokenService` and inv
 
 The default section name for the JWT settings is `jwt`. The following options are available: 
 
-`enabled` - If true then the JWT authentication is enabled.
-
-`allowAnonymousEndpoints` - If true then the JWT authentication is disabled for the endpoints with the AllowAnonymous attribute.
-
-`certificate` - Certificate used to issue or just validate the tokens (including private key or just the public one).
-
-`algorithm` - The algorithm used to sign the tokens.
-
-`issuer` - A party signing the tokens.
-
-`secretKey` - A secret key used to create the access tokens (instead of using the certificate).
-
-`expiry` - How long the token will remain valid.
-
-`validateLifetime` - If true then the lifetime defined in expiryMinutes will be validated.
-
-`validAudience` - An audience that can use the access tokens.
-
-`validateAudience` - If true then the audience defined in validAudience will be validated.
+- `enabled` - If true then the JWT authentication is enabled.
+- `allowAnonymousEndpoints` - If true then the JWT authentication is disabled for the endpoints with the AllowAnonymous attribute.
+- `certificate` - Certificate used to issue or just validate the tokens (including private key or just the public one).
+- `algorithm` - The algorithm used to sign the tokens.
+- `issuer` - A party signing the tokens.
+- `secretKey` - A secret key used to create the access tokens (instead of using the certificate).
+- `expiry` - How long the token will remain valid.
+- `validateLifetime` - If true then the lifetime defined in expiryMinutes will be validated.
+- `validAudience` - An audience that can use the access tokens.
+- `validateAudience` - If true then the audience defined in validAudience will be validated.
 
 ## Settings
 
-**appsettings.json**
+Use the following settings in the `appsettings.json` file according to your needs
 
-``` json
+```json
 "jwt": {
   "enabled": true,
   "allowAnonymousEndpoints": [
@@ -241,7 +232,7 @@ The default section name for the JWT settings is `jwt`. The following options ar
 
 Default settings for some variable has bee overwritten with the following configuration.
 
-``` json
+```json
 "jwt": {
   "challenge": "Bearer",
   "metadataAddress": "/.well-known/openid-configuration",

content/en/library/azure-key-vault/index.md

@@ -3,6 +3,7 @@ title : "Azure Key Vault"
 description: "Genocs Library package for Azure Key Vault"
 lead: ""
 date: 2023-11-29T21:00:19+02:00
+lastmod: 2024-11-17T00:00:00+02:00
 draft: false
 images: []
 menu:
@@ -58,25 +59,22 @@ builder.Host
 
 ### Options
 
-`enabled` - Enable or disable the Azure Key Vault configuration. Default is false
+- `enabled` - Enable or disable the Azure Key Vault configuration. Default is false
+- `name` - Sets the key vault name to be used. If the key vault url is `https://kyvault.vault.azure.net/` then the name is `kyvault`.
+- `managedIdentityId` - Sets the managed identity id to be used. You can find the managed identity id in the Azure portal. The managed identity id is the object id of the managed identity.
+- `azureADCertThumbprint` - The client id. To be used with *Certificate authentication*.
+- `azureADApplicationId` - The Active Directory Application id. To be used with *Certificate authentication*.
+- `azureADDirectoryId` - The Azure EntraID tenant Id. To be used with *Certificate authentication*.
 
-`name` - Sets the key vault name to be used. If the key vault url is `https://kyvault.vault.azure.net/` then the name is `kyvault`.
 
-`managedIdentityId` - Sets the managed identity id to be used. You can find the managed identity id in the Azure portal. The managed identity id is the object id of the managed identity.
+> **NOTE:** 
+>
+> In case of RBAC, you don't need to set the managed identity id.
 
-`azureADCertThumbprint` - The client id. To be used with Certificate authentication.
 
-`azureADApplicationId` - The Active Directory Application id. To be used with Certificate authentication.
+Use the following settings in the `appsettings.json` file according to your needs
 
-`azureADDirectoryId` - The Azure EntraID tenant Id. To be used with Certificate authentication.
-
-
-**NOTE:** In case of RBAC, you don't need to set the managed identity id.
-
-
-**appsettings.json**
-
-``` json
+```json
   "azureKeyVault": {
     "enabled": false,
     "name": "kyvault",

content/en/library/builder/index.md

@@ -3,7 +3,7 @@ title : "Builder"
 description: "Genocs builder is the entrypoint for the application builder."
 lead: ""
 date: 2023-12-20T17:40:19+02:00
-lastmod: 2023-12-20T17:40:19+02:00
+lastmod: 2024-11-17T00:00:00+02:00
 draft: false
 images: []
 menu:
@@ -31,7 +31,7 @@ Extend `IServiceCollection` with `AddGenocs(builder.Configuration)` that will ge
 
 This is what you need to do in the `Program.cs` file.
 
-``` c#
+```csharp
 // Create a new WebApplication
 var builder = WebApplication.CreateBuilder(args);
 
@@ -47,7 +47,7 @@ services.AddGenocs(builder.Configuration);
 
 This is an example of how to setup the builder in the `Program.cs` file along with some other services.
 
-``` c#
+```csharp
 using Genocs.Core.Builders;
 using Genocs.Core.Demo.WebApi.Infrastructure.Extensions;
 using Genocs.Core.Demo.WebApi.Options;
@@ -154,31 +154,24 @@ Log.CloseAndFlush();
 
 ## Options
 
-`name` - The service name.
-
-`service` - Service name used TBW.
-
-`instance` - The service instance.
-
-`version` - The service version.
-
-`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.
+- `name` - The service name.
+- `service` - Service name used TBW.
+- `instance` - The service instance.
+- `version` - The service version.
+- `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.
 
 ## Settings
 
-**appsettings.json**
-
 Use the following settings in the `appsettings.json` file according to your needs.
 
-``` json
+```json
   "app": {
     "name": "Service Name",
     "service": "service-name",
     "instance": "000001",
     "version": "v1.0",
     "displayBanner": true,
     "displayVersion": true
-  },
+  }
 ```