docs: add route and gatewat configuration options

docs/quickstart/distrubuted-intance.md

@@ -8,6 +8,10 @@ nav_order: 5
 
 # Distributed instances
 
+Goma Gateway includes built-in support for Redis-based rate limiting, enabling efficient and scalable deployments.
+
+By leveraging Redis, the Gateway ensures high-performance request throttling and distributed rate limiting across multiple instances, making it ideal for modern, cloud-native architectures.
+
 ```yaml
 version: "1.0"
 gateway:

docs/quickstart/extra-route.md

@@ -31,6 +31,8 @@ gateway:
     - path: /
       name: example
 ```
+## Routes Configuration
+Below is an example of configuring routes for the Gateway, defining service paths, methods, backends, health checks, and other settings.
 
 Create a file in `/etc/goma/extra` using `yaml` or `.yaml` extension.
 
@@ -86,6 +88,7 @@ Create a file in `/etc/goma/extra` using `yaml` or `.yaml` extension.
        disableHostFording: true
        interceptErrors: [404,401]
        blockCommonExploits: false
+       ## List of middleware
        middlewares:
          - auth-middleware
 

docs/quickstart/gateway.md

@@ -7,49 +7,51 @@ nav_order: 1
 
 # Gateway
 
-```yaml
-version: 1.0
-gateway:
-  sslCertFile: /etc/goma/cert.pem
-  sslKeyFile: /etc/goma/key.pem
-  writeTimeout: 15
-  readTimeout: 15
-  idleTimeout: 30
-  # Rate limiting
-  rateLimit: 0
-  accessLog: /dev/Stdout
-  errorLog: /dev/stderr
-  logLevel: info
-  ## Add additional routes
-  extraRoutes:
-    # path
-    directory: /etc/goma/extra
-    watch: true
-  disableRouteHealthCheckError: false
-  disableDisplayRouteOnStart: false
-  disableKeepAlive: false
-  disableHealthCheckStatus: false
-  blockCommonExploits: true
-  # Intercept backend errors
-  interceptErrors:
-    - 500
-  cors:
-    origins:
-      - http://localhost:8080
-      - https://example.com
-    headers:
-      Access-Control-Allow-Credentials: "true"
-      Access-Control-Allow-Headers: Origin, Authorization, Accept, Content-Type, Access-Control-Allow-Headers, X-Client-Id, X-Session-Id
-      Access-Control-Max-Age: "1728000"
-  routes: []
-```
-## Extra Routes
+The Gateway serves as the entry point to the server. This section provides options to configure the proxy server, define routes, and specify additional routes. 
 
-The Extra Routes feature allows you to define additional routes by using .yml or .yaml files stored in a specified directory.
+These settings enable precise control over traffic flow and routing within your deployment.
 
-This approach helps you avoid the complexity of managing all routes in a single file.
+## Configuration Options
 
-When dealing with many routes, maintaining them in one file can quickly become unwieldy. With this feature, you can organize your routes into separate files, making them easier to manage and maintain.
+- **`sslCertFile`** (`string`): Path to the SSL certificate file.
+- **`sslKeyFile`** (`string`): Path to the SSL certificate private key file.
+- **`redis`**: Redis configuration settings.
+- **`writeTimeout`** (`integer`): Timeout for writing responses (in seconds).
+- **`readTimeout`** (`integer`): Timeout for reading requests (in seconds).
+- **`idleTimeout`** (`integer`): Timeout for idle connections (in seconds).
+- **`rateLimit`** (`integer`): Global rate limiting for the proxy.
+- **`blockCommonExploits`** (`boolean`): Enable or disable blocking of common exploits.
+- **`accessLog`** (`string`, default: `/dev/stdout`): Path for access logs.
+- **`errorLog`** (`string`, default: `/dev/stderr`): Path for error logs.
+- **`logLevel`** (`string`): Log verbosity level (e.g., `info`, `debug`, `error`).
+- **`disableHealthCheckStatus`** (`boolean`): Enable or disable exposing the health check route status.
+- **`disableRouteHealthCheckError`** (`boolean`): Enable or disable returning health check error responses for routes.
+- **`disableDisplayRouteOnStart`** (`boolean`): Enable or disable displaying routes during server startup.
+- **`disableKeepAlive`** (`boolean`): Enable or disable `keepAlive` for the proxy.
+- **`enableMetrics`** (`boolean`): Enable or disable server metrics collection.
+- **`interceptErrors`** (`array of integers`): List of HTTP status codes to intercept for custom handling.
+
+### CORS Configuration
+
+Customize Cross-Origin Resource Sharing (CORS) settings for the proxy:
+
+- **`origins`** (`array of strings`): List of allowed origins.
+- **`headers`** (`map[string]string`): Custom headers to include in responses.
+
+### Additional Routes
+
+Define custom routes for additional flexibility:
+
+- **`directory`** (`string`): Directory path for serving extra routes.
+- **`watch`** (`boolean`): Watch the directory for changes and update routes dynamically.
+
+### Routes
+
+Define the main routes for the Gateway, enabling routing logic for incoming requests.
+
+---
+
+## Example Configuration
 
 ```yaml
 version: 1.0
@@ -72,11 +74,13 @@ gateway:
   # Intercept backend errors
   interceptErrors:
     - 500
+    - 405
   cors:
     origins:
       - http://localhost:8080
       - https://example.com
     headers:
+      X-Custom-Header: "Value"
       Access-Control-Allow-Credentials: "true"
       Access-Control-Allow-Headers: Origin, Authorization, Accept, Content-Type, Access-Control-Allow-Headers, X-Client-Id, X-Session-Id
       Access-Control-Max-Age: "1728000"

docs/quickstart/healthcheck.md

@@ -8,7 +8,9 @@ nav_order: 5
 
 # Healthcheck
 
-Goma comes with routes healthcheck, that can be enabled and disabled.
+The proxy includes built-in health check routes, which can be easily enabled or disabled based on your requirements.
+
+These routes allow you to monitor the health and availability of your services.
 
 ```yaml
 version: 1.0

docs/quickstart/route.md

@@ -10,6 +10,46 @@ nav_order: 2
 
 The Route allows you to match on HTTP traffic and direct it to the backend.
 
+
+## Configuration Options
+
+This section outlines the available configuration options for defining routes in the Gateway.
+
+### Route Configuration
+
+- **`path`** (`string`): The route path (e.g., `/api/v1/resource`).
+- **`name`** (`string`): A unique name for the route.
+- **`hosts`** (`list of strings`): A list of allowed hostnames for the route.
+- **`rewrite`** (`string`): Rewrites the incoming route path to a new path.
+- **`methods`** (`array of strings`): A list of allowed HTTP methods (e.g., `GET`, `POST`).
+- **`destination`** (`string`): The backend endpoint for the route.
+- **`backends`** (`list of strings`): A list of backend services for load balancing.
+- **`insecureSkipVerify`** (`boolean`): Disables backend TLS certificate verification.
+
+## Health Check Configuration
+
+- **`healthCheck`**:
+    - **`path`** (`string`): The health check path (e.g., `/health`).
+    - **`interval`** (`string`, default: `30s`): The interval between health checks.
+    - **`timeout`** (`string`, default: `10s`): The maximum time to wait for a health check response.
+    - **`healthyStatuses`** (`array of integers`): A list of HTTP status codes considered healthy.
+
+## CORS Configuration
+
+- **`cors`**:
+    - **`origins`** (`array of strings`): A list of allowed origins for Cross-Origin Resource Sharing (CORS).
+    - **`headers`** (`array of strings`): A list of custom headers to include in responses.
+
+## Additional Options
+
+- **`rateLimit`** (`integer`): The maximum number of requests allowed per minute.
+- **`disableHostFording`** (`boolean`): Disables proxy host forwarding for improved security.
+- **`interceptErrors`** (`array of integers`): A list of backend error status codes to intercept for custom handling.
+- **`blockCommonExploits`** (`boolean`): Enables or disables blocking of common exploits.
+- **`middlewares`** (`array of strings`): A list of middleware names applied to the route.
+
+---
+
 ### Simple route
 
 ```yaml