itsi 0.1.20 → 0.2.2

data/crates/itsi_tracing/src/lib.rs

@@ -6,7 +6,10 @@ use std::{
 use tracing::Level;
 pub use tracing::{debug, error, info, trace, warn};
 use tracing_appender::rolling;
-use tracing_subscriber::fmt::writer::BoxMakeWriter;
+use tracing_subscriber::fmt::{
+    format::{FmtSpan, JsonFields},
+    writer::BoxMakeWriter,
+};
 use tracing_subscriber::{EnvFilter, fmt, prelude::*, reload};
 use tracing_subscriber::{Layer, Registry, layer::Layered};
 
@@ -62,6 +65,10 @@ pub struct LogConfig {
     pub use_ansi: bool,
 }
 
+fn default_log_file() -> String {
+    env::var("ITSI_LOG_FILE").unwrap_or_else(|_| "itsi-app.log".into())
+}
+
 impl Default for LogConfig {
     fn default() -> Self {
         let level = env::var("ITSI_LOG").unwrap_or_else(|_| "info".into());
@@ -70,14 +77,8 @@ impl Default for LogConfig {
             _ => LogFormat::Plain,
         };
         let target = match env::var("ITSI_LOG_TARGET").as_deref() {
-            Ok("file") => {
-                let file = env::var("ITSI_LOG_FILE").unwrap_or_else(|_| "app.log".into());
-                LogTarget::File(file)
-            }
-            Ok("both") => {
-                let file = env::var("ITSI_LOG_FILE").unwrap_or_else(|_| "app.log".into());
-                LogTarget::Both(file)
-            }
+            Ok("file") => LogTarget::File(default_log_file()),
+            Ok("both") => LogTarget::Both(default_log_file()),
             _ => LogTarget::Stdout,
         };
         // If ITSI_LOG_ANSI is set, use that; otherwise, use ANSI if stdout is a TTY.
@@ -115,17 +116,23 @@ fn build_fmt_layer(
                 .with_thread_ids(false)
                 .with_writer(BoxMakeWriter::new(std::io::stdout))
                 .with_ansi(config.use_ansi)
+                .with_span_events(FmtSpan::NONE)
+                .fmt_fields(JsonFields::new())
                 .boxed(),
-            LogFormat::Json => fmt::layer()
-                .compact()
-                .with_file(false)
-                .with_line_number(false)
-                .with_target(true)
-                .with_thread_ids(false)
-                .with_writer(BoxMakeWriter::new(std::io::stdout))
-                .with_ansi(config.use_ansi)
-                .json()
-                .boxed(),
+            LogFormat::Json => {
+                fmt::layer()
+                    .compact()
+                    .with_file(false)
+                    .with_line_number(false)
+                    .with_target(true)
+                    .with_thread_ids(false)
+                    .with_writer(BoxMakeWriter::new(std::io::stdout))
+                    .with_ansi(config.use_ansi)
+                    .event_format(fmt::format().json()) // set the JSON event formatter
+                    .with_span_events(FmtSpan::NONE)
+                    .fmt_fields(JsonFields::new())
+                    .boxed()
+            }
         },
         LogTarget::File(file) => {
             let file_clone = file.clone();
@@ -140,6 +147,8 @@ fn build_fmt_layer(
                         rolling::daily(".", file_clone.clone())
                     }))
                     .with_ansi(false)
+                    .with_span_events(FmtSpan::NONE)
+                    .fmt_fields(JsonFields::new())
                     .boxed(),
                 LogFormat::Json => {
                     let file_clone = file.clone();
@@ -153,7 +162,9 @@ fn build_fmt_layer(
                             rolling::daily(".", file_clone.clone())
                         }))
                         .with_ansi(false)
-                        .json()
+                        .event_format(fmt::format().json()) // set the JSON event formatter
+                        .with_span_events(FmtSpan::NONE)
+                        .fmt_fields(JsonFields::new())
                         .boxed()
                 }
             }
@@ -169,6 +180,8 @@ fn build_fmt_layer(
                         .with_target(true)
                         .with_thread_ids(false)
                         .with_writer(BoxMakeWriter::new(std::io::stdout))
+                        .with_span_events(FmtSpan::NONE)
+                        .fmt_fields(JsonFields::new())
                         .with_ansi(config.use_ansi);
                     let file_layer = fmt::layer()
                         .compact()
@@ -179,6 +192,8 @@ fn build_fmt_layer(
                         .with_writer(BoxMakeWriter::new(move || {
                             rolling::daily(".", file_clone.clone())
                         }))
+                        .with_span_events(FmtSpan::NONE)
+                        .fmt_fields(JsonFields::new())
                         .with_ansi(false);
                     stdout_layer.and_then(file_layer).boxed()
                 }
@@ -191,7 +206,9 @@ fn build_fmt_layer(
                         .with_thread_ids(false)
                         .with_writer(BoxMakeWriter::new(std::io::stdout))
                         .with_ansi(config.use_ansi)
-                        .json();
+                        .event_format(fmt::format().json()) // set the JSON event formatter
+                        .with_span_events(FmtSpan::NONE)
+                        .fmt_fields(JsonFields::new());
                     let file_layer = fmt::layer()
                         .compact()
                         .with_file(false)
@@ -202,7 +219,9 @@ fn build_fmt_layer(
                             rolling::daily(".", file_clone.clone())
                         }))
                         .with_ansi(false)
-                        .json();
+                        .event_format(fmt::format().json()) // set the JSON event formatter
+                        .with_span_events(FmtSpan::NONE)
+                        .fmt_fields(JsonFields::new());
                     stdout_layer.and_then(file_layer).boxed()
                 }
             }
@@ -279,6 +298,7 @@ pub fn set_level(new_level: &str) {
 pub fn set_target(new_target: &str) {
     let target: LogTarget = match new_target {
         "stdout" => LogTarget::Stdout,
+        "both" => LogTarget::Both(default_log_file()),
         path => LogTarget::File(path.to_string()),
     };
     if let Some(config_mutex) = CURRENT_CONFIG.get() {

data/docs/content/_index.md

@@ -8,8 +8,7 @@ type: docs
 
 
 Itsi is a feature-packed, high performance web and application server, with first-class support for Ruby applications.
-It's a compliant Rack server with top-tier performance.
-It's *also* a well-equipped Reverse Proxy, API Gateway and Static file server, controlled by an intuitive and elegant configuration API and DSL.
+It's a compliant Rack server. It’s also a well-equipped reverse-proxy, API gateway, and static file server, controlled by an intuitive and elegant configuration API and DSL.
 
 
 Itsi is motivated by the belief that:

data/docs/content/acknowledgements/_index.md

@@ -1,11 +1,12 @@
 ---
 title: Acknowledgements
 type: docs
+prev: itsi_scheduler/
 sidebar:
   exclude: true
 ---
 
-Itsi is **heavily** is dependent on and/or heavily inspired by a long list of related projects and individuals.
+Itsi has a long list of **critical** dependencies and **strong** influences.
 
 
 ## Key Dependencies
@@ -17,6 +18,8 @@ It is an absolutely essential component of Itsi.
 Tokio is a fast and featureful asynchronous runtime for Rust.
 It is the backbone of *all* asynchronous IO in Itsi.
 
+* [rb-sys](https://github.com/oxidize-rb/rb-sys) and [magnus](https://github.com/matsadler/magnus), two essential libraries for building Ruby extensions in Rust.
+
 * and many more [essential](https://github.com/wouterken/itsi/blob/main/crates/itsi_server/Cargo.toml) Rust crates!
 
 * [hugo](https://gohugo.io/) and [hextra](https://imfing.github.io/hextra/) - generating *this very page* and allowing me to put together
@@ -24,7 +27,7 @@ this website with minimal effort.
 
 
 ## Inspiration
-* [Puma](https://puma.io/) is a long-standing industry heavy-weight and the current leading choice of Web Server in the Ruby ecosystem.
+* [Puma](https://puma.io/) is a long-standing industry heavyweight and the current leading choice of web server in the Ruby ecosystem.
 It's mature, stable and rock solid. Many features and interfaces of Itsi have been inspired by Puma.
 
 * [NGINX](https://nginx.org/) is a popular open-source web server and reverse proxy server.

data/docs/content/configuration/_index.md

@@ -2,7 +2,8 @@
 title: Configuration
 type: docs
 weight: 3
-next: /options/
+next: options/
+prev: getting_started/
 ---
 
 ## Itsi.rb
@@ -13,13 +14,13 @@ If you're ready to get stuck in and learn all about what Itsi has to offer, use
 
 
 ## Out-of-the-box
-If you prefer a more gradual introduction, Itsi provides several "out-of-the box" capabilities that you can take immediate advantage of *without*, needing to start a dedicated configuration file.
+If you prefer a more gradual introduction, Itsi provides several out-of-the box capabilities that you can take advantage of immediately, *without* needing to create a dedicated configuration file.
 
 
 
 ## Run Rack Applications
 Itsi will automatically host your Rack application if you launch it in a directory with a `config.ru` file.
-This means, it's a drop in server replacement for your favourite `Rails`, `Hanami`, or `Sinatra` applications.
+This means, it's a drop-in server replacement (and potentially a free performance boost) for your favorite `Rails`, `Hanami`, or `Sinatra` applications.
 
 To get started just run
 ```ruby
@@ -33,7 +34,7 @@ There's also a Rails adapter allowing you to add it to your Gemfile and launch i
 rails server -U itsi
 ```
 {{< callout type="info" >}}
-  Note that `rails server -U itsi` runs Itsi with a intentionally minimal footprint, specifically for development purposes. To take full advantage of Itsi's concurrency features,
+  Note that `rails server -U itsi` runs Itsi with an intentionally minimal footprint, specifically for development purposes. To take full advantage of Itsi's concurrency features,
 it's advised you tweak these inside a dedicated `Itsi.rb` file.
   {{< /callout >}}
 
@@ -90,8 +91,10 @@ COMMAND:
     restart - Restart the server
     add_worker - Add a new worker to the server cluster
     remove_worker - Remove a worker from the server cluster
+    test - Test config file validity
     routes - Print the routes of the server
-    passfile - Manage hashed users and passwords in a passfile (like .htpasswd). [add, remove, list]
+    passfile - Manage hashed users and passwords in a passfile (like .htpasswd). [add, echo, remove, list]
+    secret - Generate a new secret for use in a JWT verifier
     test_route - Test which route a request will be routed to
     static - Serve static assets in the given directory
 

data/docs/content/contact/_index.md

@@ -1,7 +1,14 @@
 ---
 title: Contact
 type: docs
-weight: 3
 sidebar:
   exclude: true
 ---
+<img src="../itsi-server-100.png" alt="asd" width="80px" style="display: block; margin-left: auto; margin-right: auto;">
+
+*	GitHub: [@wouterken](https://github.com/wouterken/)
+*	Email: [wc@pico.net.nz](mailto:wc@pico.net.nz)
+
+For general inquiries, please feel free to contact me via email at wc@pico.net.nz.
+
+For issues and bugs, please open an issue on GitHub at https://github.com/wouterken/itsi/issues.

data/docs/content/faqs/_index.md

@@ -1,10 +1,12 @@
 ---
-title: F.A.Qs
+title: FAQs
 type: docs
+prev: middleware/
+next: utilities/
 ---
 
 {{% details title="Is it just for Ruby applications?" closed="true" %}}
-**No!** While one of Itsi's goals is to be the most frictionless way to get Ruby onto the web, it stands alone as a powerful Reverse Proxy, Static File Server and API Gateway.
+**No!** While one of Itsi's goals is to be the most frictionless way to get Ruby onto the web, it stands alone as a powerful reverse Proxy, static File Server and API gateway.
 
 You can have Itsi sit in front of *any* application that speaks HTTP and immediately benefit from security middleware, performance enhancements, and more.
 You will need to write a little bit of Ruby, just to configure your Itsi server inside the `Itsi.rb` file. Who knows, maybe you'll learn to love it!
@@ -17,7 +19,7 @@ Take a look at the [Cargo.toml](https://github.com/wouterken/itsi/blob/main/crat
 This is exposed via a robust and ergonomic Ruby DSL.
 {{% /details %}}
 
-{{% details title="What License is it under?" closed="true" %}}
+{{% details title="What license is it under?" closed="true" %}}
 Itsi is an open source project licensed under the terms of the [LGPLv3](https://www.gnu.org/licenses/lgpl-3.0.en.html).
 
 You can integrate and use Itsi in your projects—whether they are open source or proprietary—without any licensing fees or obligations, as long as you use Itsi in its unmodified form. However, if you modify Itsi’s source code and distribute the modified version, you are required to release your modifications under the same LGPLv3 license.

data/docs/content/features/_index.md

@@ -2,11 +2,12 @@
 title: Features
 type: docs
 weight: 1
+next: /getting_started
 ---
 
 Itsi bundles a slew of essential modern web features into a single, easy-to-use package.
-Here's a list of several of the essentials.
-Jump straight in to [install Itsi](/getting_started) and [configure it](/configuration) for a deeper dive.
+Here's a list of the essentials.
+Or jump straight in to <a target="_blank" href="tsi](/getting_started)">install</a> and <a target="_blank" href="t](/configuration)"> configure</a> for a deeper dive.
 
 {{< callout >}}
 You don't need to use all of the features listed below to benefit from Itsi. E.g.
@@ -25,33 +26,33 @@ Pick and choose **just** the features that make sense for you.
 * Streaming compression
 * Serve static precompressed files from the file-system
 * gRPC compression (`zlib` and `gzip`)
-* See [compression](/middleware/compression)
+* See <a target="_blank" href="/middleware/compression">compression</a>
 {{% /details %}}
 
 {{% details title="CORS" closed="true" %}}
 * Full control over CORS rules on a location-by-location basis.
-* See [cors](/middleware/cors)
+* See <a target="_blank" href="/middleware/cors">cors</a>
 {{% /details %}}
 
 {{% details title="ETag and Cache Control" closed="true" %}}
 * Weak and Strong eTag support.
 * `If-None-Match` and `If-Modified-Since` support.
 * Automated etag generation for dynamic content (or forwarding of existing `etags` if present)
-* See [etag](/middleware/etag)
+* See <a target="_blank" href="/middleware/etag">etag</a> and <a target="_blank" href="/middleware/cache_control">cache_control</a>
 {{% /details %}}
 
-{{% details title="Conditional Middleware" closed="true" %}}
+{{% details title="Configurable Middleware" closed="true" %}}
 * Expressive controls to apply middleware selectively on a request-by-request basis.
 * Expressive matching based on route, content-type and body size, hostnames etc.
 * A single Itsi process can support simultaneous running of several apps, each with specialized configuration.
-* See [location](/middleware/location)
+* See <a target="_blank" href="/middleware/location">location</a>
 {{% /details %}}
 
 {{% details title="Redirects" closed="true" %}}
 * Simple redirect functionality (all of `permanent`, `temporary`, `found`, `moved_permanently`)
-* HTTP to HTTPs Redirects
+* HTTP to HTTPS Redirects
 * Dynamic URL Rewriting
-* See [redirect](/middleware/redirect)
+* See <a target="_blank" href="/middleware/redirect">redirect</a>
 {{% /details %}}
 
 {{% details title="Reverse Proxy" closed="true" %}}
@@ -61,12 +62,12 @@ Pick and choose **just** the features that make sense for you.
 * Multiple backends per host, with load balancing and failover support
 * Automatic retries for Idempotent requests
 * Configurable error pages
-* See [proxy](/middleware/proxy)
+* See <a target="_blank" href="/middleware/proxy">proxy</a>
 {{% /details %}}
 
 {{% details title="Range Requests" closed="true" %}}
 * Partial content delivery support, so clients can resume downloads or stream large files efficiently.
-* See [static_assets](/middleware/static_assets)
+* See <a target="_blank" href="/middleware/static_assets">static_assets</a>
 {{% /details %}}
 
 {{% details title="Static File Server" closed="true" %}}
@@ -75,31 +76,31 @@ Efficiently serves static assets with proper content types and caching headers.
 * Configurable in-memory caching for faster serving of small and frequently accessed files.
 * Auto try `.html` extension (for cleaner paths)
 * Configurable fallback behaviour (e.g. route request misses to an index.html for SPAs)
-* See [static_assets](/middleware/static_assets)
+* See <a target="_blank" href="/middleware/static_assets">static_assets</a>
 {{% /details %}}
 
 {{% details title="Multiple Binds" closed="true" %}}
 * Itsi can listen on multiple IP addresses or ports simultaneously for flexible deployment.
 * Unix socket binds (both plain-text and TLS) are supported.
-* See [bind](/options/bind).
+* See <a target="_blank" href="/options/bind">bind</a>.
 {{% /details %}}
 
 ## DevOps
 {{% details title="File Watcher & Live Reloading" closed="true" %}}
 * Monitors file changes and to automatically reloads configuration or content.
 * Use custom watchers to e.g. trigger frontend builds on file changes.
-* See [local_development](/getting_started/local_development).
+* See <a target="_blank" href="/getting_started/local_development">local_development</a>, <a target="_blank" href="/options/auto_reload_config">auto_reload_config</a>, and <a target="_blank" href="/options/watch">watch</a>.
 {{% /details %}}
 
 {{% details title="LSP and shell completion support" closed="true" %}}
 * The bundled RubyLSP addon provides rich inline documentation and hover support when editing `Itsi.rb` files.
-* Shell completion support (just add `eval "$(itsi --install-completions)"` to the bottom of your shell init file)
-* See [local_development](/getting_started/local_development).
+* Shell completion support (add `eval "$(itsi --install-completions)"` to the bottom of your shell init file)
+* See <a target="_blank" href="/getting_started/local_development">local_development</a>.
 {{% /details %}}
 
 {{% details title="Status Reporting" closed="true" %}}
 * Send SIGUSR2 to trigger detailed status report across all Itsi processes.
-* See [signals](/getting_started/signals).
+* See <a target="_blank" href="/getting_started/signals">signals</a>.
 {{% /details %}}
 
 {{% details title="Granular Logging" closed="true" %}}
@@ -107,25 +108,25 @@ Efficiently serves static assets with proper content types and caching headers.
 * Support `STDOUT`, file-system and combined log sinks.
 * Apply selective log levels for specific log targets only.
 * Configurable request logging middleware, with custom log templates.
-* See [log_responses](/middleware/log_responses) & [logging](/getting_started/logging).
+* See <a target="_blank" href="/middleware/log_requests">Request Logs</a> & <a target="_blank" href="/getting_started/logging">Logging</a>.
 {{% /details %}}
 
 {{% details title="Hot Config Reloads & Config File Validation" closed="true" %}}
 * Zero-downtime config file reloads.
 * Phased restart support when running in `cluster` mode
 * Config file testing and dry-run functionality
-* See [hot_reloads](/getting_started/hot_reloads).
+* See <a target="_blank" href="/getting_started/signals">signals</a> and <a target="_blank" href="/options/auto_reload_config">auto_reload_config</a>.
 {{% /details %}}
 
 {{% details title="Configurable Error Responses" closed="true" %}}
 * Provide your own exception responses (HTML and JSON) for all common exception scenarios, or simply rely on the light-weight defaults.
-* See [error_responses](/middleware/error_responses).
+* See <a target="_blank" href="/middleware/error_response">error_responses</a>.
 {{% /details %}}
 
 {{% details title="Management Signals" closed="true" %}}
 * Use a full suite of Unix signals to control your live Itsi cluster.
 * Add or remove workers on the fly, reload config, generate status reports etc.
-* See [signals](/getting_started/signals).
+* See <a target="_blank" href="/getting_started/signals">signals</a>.
 {{% /details %}}
 
 ## Security
@@ -137,118 +138,123 @@ Efficiently serves static assets with proper content types and caching headers.
 
 Itsi also comes bundled with a passfile generator, to help you manage your password hashes effectively.
 
-* See [auth_jwt](/middleware/auth_jwt), [auth_api_key](/middleware/auth_api_key), [auth_basic](/middleware/auth_basic) and [passfile](/getting_started/passfile).
+* See <a target="_blank" href="/middleware/auth_jwt">auth_jwt</a>, <a target="_blank" href="/middleware/auth_api_key">auth_api_key</a>, <a target="_blank" href="/middleware/auth_basic">auth_basic</a> and <a target="_blank" href="/utilities/passfile_generator">passfile</a>.
 {{% /details %}}
 
 {{% details title="Automatic Let's Encrypt Certificates" closed="true" %}}
 * Automated provisioning of Let's Encrypt certificates.
 * File system caching of certificate data to avoid excessive API calls.
 * Supports usage of subject alternative names (SANs) for certificates that span multiple domains/sub-domains.
-* See [bind](/options/bind).
+* See <a target="_blank" href="/options/certificates#production-certificates-lets-encrypt">certificates</a>.
 {{% /details %}}
 
 {{% details title="Automatic Development Certificates" closed="true" %}}
 * Easily mirror your production SSL set-up in Development
 * Custom local CA generation (add this CA cert to your trusted root certificates for warning-less SSL during local development)
-* See [bind](/options/bind).
+* See <a target="_blank" href="/options/certificates#development">certificates</a>.
 {{% /details %}}
 
 {{% details title="(Distributed) Rate Limiting" closed="true" %}}
 * Combine any number of configurable rate limits
 * Support for a `Redis` backend for distributed rate limiting (falls back to in-memory backend)
 * In-memory backend for simple setups and local development.
-* See [rate_limit](/middleware/rate_limit).
+* See <a target="_blank" href="/middleware/rate_limit">rate_limit</a>.
 {{% /details %}}
 
 {{% details title="Allow & Deny Lists" closed="true" %}}
 * IP Allow lists to limit access to a specific set of IP addresses or blocks.
 * IP Deny lists to block access from specific IP addresses or blocks.
-* See [allow_list](/middleware/allow_list) & [deny_list](/middleware/deny_list).
+* See <a target="_blank" href="/middleware/allow_list">allow_list</a> & <a target="_blank" href="/middleware/deny_list">deny_list</a>.
 {{% /details %}}
 
 {{% details title="Intrusion Protection" closed="true" %}}
 * Automatically scan request paths and headers for known malicious patterns
 * Configurable ban rules to block offenders for a specified duration.
-* See [intrusion_protection](/middleware/intrusion_protection)
+* See <a target="_blank" href="/middleware/intrusion_protection">intrusion_protection</a>
 {{% /details %}}
 
 {{% details title="Slowhttp attack prevention" closed="true" %}}
 * Protections against several slowhttp attacks (e.g. Slowloris, Slowbody), through header and request timeouts and maximum request body sizes.
-* See [max_body](/options/max_body), [request_timeout](/options/request_timeout) and [header_read_timeout](/options/header_read_timeout)
+* See <a target="_blank" href="/options/max_body">max_body</a>, <a target="_blank" href="/options/request_timeout">request_timeout</a> and <a target="_blank" href="/options/header_read_timeout">header_read_timeout</a>
 {{% /details %}}
 
 {{% details title="CSP Reporting" closed="true" %}}
 * Simple configuration for enabling CSP headers.
 * Support for hosting a CSP reporting endpoint to track violations of CSPs running in reporting only mode.
-* See [CSP](/middleware/csp)
+* See <a target="_blank" href="/middleware/csp">CSP</a>
 {{% /details %}}
 
 ## Protocols & Standards
 {{% details title="HTTP2" closed="true" %}}
 * Benefit from connection multiplexing by using http2 all the way from client to app/file server.
-* `Itsi`'s  underlying HTTP1 and 2 implementations are provided directly by [hyper](https://github.com/hyperium/hyper). Itsi simply exposes these existing capabilities. This means that once [h3](https://hyper.rs/contrib/roadmap/#http3) lands in Hyper - we'll get it in Itsi too!
+* `Itsi`'s  underlying HTTP1 and 2 implementations are provided directly by <a target="_blank"  href="https://github.com/hyperium/hyper">hyper</a>. Itsi simply exposes these existing capabilities. This means that once <a target="_blank" href="https://hyper.rs/contrib/roadmap/#http3">h3</a> lands in Hyper - we'll get it in Itsi too!
 {{% /details %}}
 
 {{% details title="Rack Server" closed="true" %}}
 * Rack compliant. Itsi plays nicely with your existing Rack-based applications and middleware.
-* See [run](/middleware/run) and [rack_file](/middleware/rack_file)
+* See <a target="_blank" href="/middleware/run">run</a> and <a target="_blank" href="/middleware/rackup_file">rackup_file</a>
 {{% /details %}}
 
 {{% details title="gRPC Server" closed="true" %}}
 * Itsi is compatible with ruby `grpc` service handlers and can
-replace the [official Ruby gRPC server implementation](https://github.com/grpc/grpc/blob/master/src/ruby/README.md) for a free performance boost!
-* Consider implementing non-blocking IO to further enhance performance.
+replace the <a  target="_blank" href="https://github.com/grpc/grpc/blob/master/src/ruby/README.md">official</a> Ruby gRPC server implementation for a free performance boost!
+* Consider enabling [non-blocking IO](/options/fiber_scheduler) to further enhance performance.
 * Support for gRPC server reflection (use with tools like evans and Postman for easy service discovery)
 * Support for gzip and zlib compression
-* See [grpc](/middleware/grpc)
+* See <a target="_blank" href="/middleware/grpc">grpc</a>
 {{% /details %}}
 
 {{% details title="gRPC+REST compatibility mode" closed="true" %}}
 * Itsi provides a `gRPC+REST` compatibility layer for easy reuse of gRPC endpoints by clients and environments that are not gRPC capable. Invoke unidirectional and streaming endpoints using plain-old JSON.
-* See [grpc](/middleware/grpc)
+* See <a target="_blank" href="/middleware/grpc">grpc</a>
 {{< callout type="warn" >}}
-Note: This is not the same as [gRPC with Json](https://grpc.io/blog/grpc-with-json/), which swaps out protobuf for JSON but still relies on gRPC's underlying framing mechanics.
+Note: This is not the same as <a target="_blank" href="https://grpc.io/blog/grpc-with-json/">gRPC with JSON</a> which swaps out protobuf for JSON but still relies on gRPC's underlying framing mechanics.
 {{< /callout >}}
 {{% /details %}}
 
 {{% details title="WebSockets" closed="true" %}}
-* WebSocket support for Rack apps (e.g. [ActionCable](https://guides.rubyonrails.org/action_cable_overview.html))
+* WebSocket support for Rack apps (e.g. <a target="_blank" a href="https://guides.rubyonrails.org/action_cable_overview.html">ActionCable</a>)
 {{% /details %}}
 
 ## Concurrency & Performance
 {{% details title="Cluster Mode" closed="true" %}}
 * Supports running in a clustered mode, to fully leverage multi-core systems.
-* See [workers](/options/workers).
+* See <a target="_blank" href="/options/workers">workers</a>.
 {{% /details %}}
 
 {{% details title="Non-blocking(Fiber Scheduler) Mode" closed="true" %}}
 * Support for Ruby’s fiber scheduler for non-blocking concurrency, boosting performance during I/O operations.
-* Use Itsi's own high-performance build-in [Fiber scheduler](/itsi_scheduler), or if your prefer you can bring your own!
-* See [fiber_scheduler](/options/fiber_scheduler).
+* Use Itsi's own high-performance built-in <a target="_blank" href="/itsi_scheduler">Fiber Scheduler</a> or if your prefer you can bring your own!
+* See <a target="_blank" href="/options/fiber_scheduler">fiber_scheduler</a>.
 {{% /details %}}
 
 {{% details title="Hybrid Blocking/Non-Blocking Mode" closed="true" %}}
 * `Itsi` allows you to split endpoints between using a Fiber scheduler versus running using the traditional blocking IO model. This allows you to dip your toes into the waters of Ruby's new non-blocking IO, without having to port an entire application at once!
-* See [scheduler_threads](/options/scheduler_threads).
+* See <a target="_blank" href="/options/scheduler_threads">scheduler_threads</a>.
 {{% /details %}}
 
 {{% details title="Non-blocking by design" closed="true" %}}
-* Itsi is underpinned by [hyper](https://hyper.rs/) and [tokio](https://tokio.rs/) and as such is fundamentally an evented, non-blocking server. Whether you're proxying, serving large files, or delegating to Ruby endpoints, `Itsi` remains responsive, even under heavy load.
+* Itsi is underpinned by <a target="_blank" href="https://hyper.rs/">hyper</a> and <a target="_blank" href="https://tokio.rs/">tokio</a> and as such is fundamentally an evented, non-blocking server. Whether you're proxying, serving large files, or delegating to Ruby endpoints, `Itsi` remains responsive, even under heavy load.
 {{% /details %}}
 
 ## Ruby
 {{% details title="Preloading" closed="true" %}}
 * Preload your Ruby application code before forking to benefit from reduced memory through CoW
 * Alternatively, use groups in bundler to target specific gems or dependencies for preloading
-* See [preload](/options/preload).
+* See <a target="_blank" href="/options/preload">preload</a>.
 {{% /details %}}
 
-{{% details title="Streaming Bodies" closed="true" %}}
-* For both [streaming and enumerable bodies](https://github.com/rack/rack/blob/main/SPEC.rdoc#the-body-), Itsi sends data to the client as soon as it is available. This means modules like [ActionController::Live](https://api.rubyonrails.org/v7.1/classes/ActionController/Live.html) behave as expected, and the minimal buffering keeps `Itsi`'s memory footprint consistently low.
+{{% details title="Streaming Response Bodies" closed="true" %}}
+* For both <a target="_blank" href="https://github.com/rack/rack/blob/main/SPEC.rdoc#the-body-">streaming</a> and <a target="_blank" href="https://github.com/rack/rack/blob/main/SPEC.rdoc#enumerable-body-">Enumerable</a> bodies, Itsi sends data to the client as soon as it is available. This means modules like <a target="_blank"  href="https://api.rubyonrails.org/v7.1/classes/ActionController/Live.html">ActionController</a> behave as expected, and the minimal buffering keeps `Itsi`'s memory footprint consistently low.
+{{% /details %}}
+
+{{% details title="Streaming Request Bodies" closed="true" %}}
+* Itsi supports streaming incoming request bodies too, for efficient processing of large simultaneous input streams (Disabled by default for maximum compatibility).
+* See <a target="_blank" href="/options/stream_body">stream_body</a>.
 {{% /details %}}
 
 {{% details title="Full & Partial Rack Hijacking" closed="true" %}}
-* Itsi supports both [full and partial Rack hijacking](https://github.com/rack/rack/blob/main/SPEC.rdoc#hijacking-). Even over HTTP2!
+* Itsi supports both <a href="https://github.com/rack/rack/blob/main/SPEC.rdoc#hijacking-" target="_blank">full</a> and partial Rack hijacking. Even over HTTP2!
 {{< callout type="warn" >}}
 By design, Full hijacking assumes you are writing a raw HTTP1 response directly to a raw connection stream.
 Itsi's support for full hijack over HTTP2 is similar to what you would see if running a dedicated reverse proxy in front of a Ruby app.
@@ -258,7 +264,7 @@ Itsi translates that request from HTTP1 to HTTP2, in real-time, allowing full hi
 
 {{% details title="Sendfile" closed="true" %}}
 * Itsi allows Ruby apps to set a `X-Sendfile` header to enable efficient, streaming file transfers, outside of Ruby, via fast native code.
-* See [run](/middleware/run) and [rack_file](/middleware/rack_file).
+* See <a target="_blank" href="/middleware/run">run</a> and <a target="_blank" href="/middleware/rackup_file">rackup_file</a>.
 
 {{< callout type="info" >}}
 Note that despite the header being named `X-Sendfile`, Itsi does not use the Sendfile system call, instead delegating the efficient streaming to Tokio's native asynchronous file streaming capabilities.
@@ -269,17 +275,17 @@ Note that despite the header being named `X-Sendfile`, Itsi does not use the Sen
 {{% details title="Graceful Memory Limits" closed="true" %}}
 * Itsi allows you to specify memory limits for Ruby processes. When the limit is reached, Itsi gracefully terminates the process and also invokes a dedicated `after_memory_threshold_reached` callback,
 so that you can log the event for further analysis.
-* See [worker_memory_limit](/options/worker_memory_limit) and  [after_memory_threshold_reached](/options/after_memory_threshold_reached).
+* See <a target="_blank" href="/options/worker_memory_limit">worker_memory_limit</a> and  <a target="_blank" href="/options/after_memory_threshold_reached">after_memory_threshold_reached</a>.
 {{% /details %}}
 
 {{% details title="OOB GC" closed="true" %}}
 * Itsi can be configured to periodically trigger GC every N idle periods (where an idle period is defined as a time where no requests are currently queued).
 * Periodic triggering of GC outside of the request flow can help reduce the impact of GC on latency.
-* See [oob_gc_threshold](/options/oob_gc_threshold)
+* See <a target="_blank" href="/options/oob_gc">oob_gc_threshold</a>
 {{% /details %}}
 
 {{% details title="'Rackless' Ruby Apps" closed="true" %}}
 * Itsi allows definition of ultra-light-weight Ruby web-apps, using plain old functions and procs.
 * For simple endpoints this barebones option can provide a substantial increase in throughput over a Rack request (primarily by avoiding allocating the env hash and response array)
-* See [endpoint](/middleware/endpoint)
+* See <a target="_blank" href="/middleware/endpoint">endpoint</a>
 {{% /details %}}

data/docs/content/getting_started/_index.md

@@ -2,6 +2,8 @@
 title: Getting Started
 type: docs
 weight: 2
+prev: features/
+next: getting_started/local_development/
 ---
 
 {{% steps %}}
@@ -49,7 +51,7 @@ Install Ruby
   {{< /callout >}}
 
   {{< /tab >}}
-  {{< tab >}}**Windows**: Itsi currently doesn't support native Windows builds, but it runs great on [https://learn.microsoft.com/en-us/windows/wsl/install](WSL).
+  {{< tab >}}**Windows**: Itsi currently doesn't support native Windows builds, but it runs well on [https://learn.microsoft.com/en-us/windows/wsl/install](WSL).
 
   Follow the linked instructions to Install a linux distribution like Ubuntu or Debian and then follow the instructions in the Linux tab.
   {{< /tab >}}
@@ -60,11 +62,12 @@ Install Ruby
 
 Great! You now have Itsi installed. Go to one of the following pages to learn how to use it:
 
+
 {{< cards >}}
-  {{< card link="../features" title="Essential Features" icon="star" >}}
-  {{< card link="../configuration" title="Configuration" icon="adjustments" >}}
-  {{< card link="../reverse_proxy" title="Reverse Proxy & Gateway" icon="arrow-circle-right" >}}
-  {{< card link="../for_rubyists" title="For Ruby Apps" icon="library" >}}
+  {{< card link="./local_development" title="Local Development" icon="star" >}}
+  {{< card link="../options" title="Options" icon="adjustments" >}}
+  {{< card link="../middleware" title="Middleware" icon="cog" >}}
+  {{< card link="https://github.com/wouterken/itsi" title="Source Code" icon="github" >}}
 {{< /cards >}}
 
 {{% /steps %}}