refactor(documentation): update

Author: stratdev3

documentation/simplew/docs/addons/helper-hosting.md

@@ -50,7 +50,7 @@ var builder = SimpleWHost.CreateApplicationBuilder(args);
 
 builder.ConfigureSimpleW(server => {
     server.MapGet("/hello", () => {
-        return new { mesage = "Hello World !" };
+        return new { message = "Hello World !" };
     });
 });
 
@@ -95,7 +95,7 @@ builder.ConfigureSimpleW(server => {
     server.UseHttps(); // native SimpleW HTTPS support, see documentation
 
     server.MapGet("/hello", () => {
-        return new { mesage = "Hello World !" };
+        return new { message = "Hello World !" };
     });
 });
 ```

documentation/simplew/docs/guide/observability.md

@@ -194,7 +194,7 @@ server.ConfigureTelemetry(options => {
     options.IncludeStackTrace = true;
     options.EnrichWithHttpSession = (activity, session) => {
         // override host with the X-Forwarded-Host header (set by a trusted reverse proxy)
-        if (session.Request.Headers.TryGetValue("X-Forwarded-Host", out string? host) {
+        if (session.Request.Headers.TryGetValue("X-Forwarded-Host", out string? host)) {
             activity.SetTag("url.host", host);
         }
     };

documentation/simplew/docs/index.md

@@ -26,13 +26,13 @@ hero:
 features:
     - icon: ⚡
       title: Zero Dependencies, Maximum Speed
-      details: Built on top of native sockets. Minimal overhead, instant startup and high-performance workloads.
+      details: Built on top of native sockets. Minimal overhead, instant startup and strong performance under load.
     - icon: 🌐
       title: Flexible Web Server
       details: Handle APIs, static files, and dynamic content through a simple routing model — with full control over behavior.
     - icon: 🛡️
       title: Production-Grade Core
-      details: A fully integrated core designed for real-world usage covering security, communication, and observability without external dependencies.
+      details: A fully integrated core designed for real-world usage, covering security, communication, and observability without external dependencies.
     - icon: 🧩
       title: Powerful Addons
       details: Designed for extensibility. Integrate additional capabilities through independent modules without bloating your core.
@@ -57,7 +57,7 @@ server.MapGet("/api/test/hello", () => {
     return new { message = "Hello World !" };
 });
 
-// start a blocking background server
+// run server
 await server.RunAsync();
 ```
 
@@ -90,12 +90,6 @@ class Program {
         // telemetry
         server.ConfigureTelemetry(options => {
             options.IncludeStackTrace = true;
-            options.EnrichWithHttpSession = (activity, session) => {
-                // override host with the X-Forwarded-Host header (set by a trusted reverse proxy)
-                if (session.Request.Headers.TryGetValue("X-Forwarded-Host", out string? host) {
-                    activity.SetTag("url.host", host);
-                }
-            };
         });
 
         // socket tuning
@@ -119,7 +113,7 @@ class Program {
             options.AllowRules.Add(IpRule.Cidr("10.0.0.0/8"));
             options.AllowRules.Add(IpRule.Single("127.0.0.1"));
             options.MaxMindCountryDbPath = "/app/data/GeoLite2-Country.mmdb";
-            options.AllowCountries.Add(CountryRule.Any("US"));
+            options.AllowCountries.Add(CountryRule.Any("FR"));
         });
 
         // OpenID
@@ -132,7 +126,7 @@ class Program {
             });
         });
 
-        // start a blocking background server
+        // run server
         await server.RunAsync();
     }
 }
@@ -166,10 +160,10 @@ builder.ConfigureSimpleW(server => {
         });
         // routes
         server.MapGet("/hello", () => {
-            return new { mesage = "Hello World !" };
+            return new { message = "Hello World !" };
         });
         // ssl
-        X509Certificate2 cert = new(@"C:\Users\SimpleW\ssl\domain.pfx", "password");
+        X509Certificate2 cert = new(@"/app/ssl/domain.pfx", "password");
         var sslcontext = new SslContext(SslProtocols.Tls12 | SslProtocols.Tls13, cert, clientCertificateRequired: false, checkCertificateRevocation: false);
         server.UseHttps(sslcontext);
     },

documentation/simplew/docs/version/faq.md

@@ -13,10 +13,19 @@ Because I strongly believe in open source, and I use open-source software every
 
 Github is just a mirror. Ping me, if your code is interesting and still MIT license, I will pull from your repo.
 
+> Do I need the ASP.NET runtime ?
+
+Hell no. SimpleW targets the standard .NET runtime — no ASP.NET overhead, no bloat.
+That said, if you want to run both side by side, nothing stops you from using the ASP.NET runtime — SimpleW will work just fine.
+
 > Why do you hate ASP.NET Core ?
 
 I don't hate it, but I don't like it (see the paragraph about [Why this library exists](../guide/what-is-simplew.md#why-this-library)).
 
+> Do you like Kestrel ?
+
+Kestrel is an awesome server. I just want a serious alternative to its hegemony.
+
 > Why is there no DI in SimpleW like in ASP.NET Core?
 
 I really deeply hate how Dependency Injection works in ASP.NET Core. I hate how the framework resolves the full dependency graph recursively and instantiates everything through a DI container :
@@ -25,10 +34,6 @@ I really deeply hate how Dependency Injection works in ASP.NET Core. I hate how
 - It tends to hide the actual object graph, which can make the execution flow harder to understand and debug
 - It usually introduces a fair amount of boilerplate and configuration for relatively simple use cases
 
-> Do you like Kestrel ?
-
-Kestrel is an awesome server. I just want a serious alternative to its hegemony.
-
 > What is the primary goal of SimpleW ?
 
 It's in the name : **simplicity first** ! <br />