docs: v2 updates

Author: almeidapaulopt

docs/content/docs/_index.md

@@ -1,5 +1,5 @@
 ---
-linkTitle: "Documentation v1"
+linkTitle: "Documentation"
 title: Introduction
 weight: 1
 ---

docs/content/docs/v2/providers/_index.md

@@ -4,9 +4,7 @@ prev: /docs/serverconfig
 weight: 3
 ---
 
-TODO
-
 {{< cards >}}
   {{< card link="docker" title="Docker" icon="view-boards" >}}
-  {{< card link="list" title="Lists" icon="server" >}}
+  {{< card link="lists" title="Lists" icon="server" >}}
 {{< /cards >}}

docs/content/docs/v2/providers/lists.md

@@ -121,6 +121,6 @@ proxyname: # Name of the proxy
 > You only need to restart TSDProxy if your changes are in /config/tsdproxy.yaml
 
 > [!NOTE]
-> See available icons in [icons](/advanced/icons).
+> See available icons in [icons](../../advanced/icons).
 
 {{% /steps %}}

docs/content/docs/v2/serverconfig.md

@@ -4,153 +4,152 @@ weight: 2
 next: /providers
 ---
 
+ TSDProxy utilizes the configuration file `/config/tsdproxy.yaml` for its settings.
 
-TSDProxy uses the configuration file `/config/tsdproxy.yaml`
-
-> [!IMPORTANT]
-> The environment variables configuration used until v0.6.0 is deprecated and
-> will be removed in the future.
+ > [!IMPORTANT]
+ > Environment variable configurations used in versions prior to v0.6.0 are
+ > deprecated and will be removed in future releases.
 
 {{% steps %}}
 
-### Sample configuration File
+### Sample Configuration File
 
-> [!WARNING]
-> Configuration files are case sensitive
+> [!Warning]
+> Configuration files are case-sensitive.
 
-```yaml  {filename="/config/tsdproxy.yaml"}
+```yaml {filename="/config/tsdproxy.yaml"}
 defaultProxyProvider: default
 docker:
-  local: # name of the docker target provider
-    host: unix:///var/run/docker.sock # host of the docker socket or daemon
-    targetHostname: 172.31.0.1 # hostname or IP of docker server
-    defaultProxyProvider: default # name of which proxy provider to use
+  local: # Name of the Docker target provider
+    host: unix:///var/run/docker.sock # Docker socket or daemon address
+    targetHostname: 172.31.0.1 # Docker server hostname or IP
+    defaultProxyProvider: default # Default proxy provider for this Docker server
 lists:
-  critical: # Name the target provider
-    filename: /config/critical.yaml # file with the proxy list
-    defaultProxyProvider: tailscale1 # (optional) default proxy provider
-    defaultProxyAccessLog: true # (optional) Enable access logs
+  critical: # Name of the target list provider
+    filename: /config/critical.yaml # Path to the proxy list file
+    defaultProxyProvider: tailscale1 # (Optional) Default proxy provider for this list
+    defaultProxyAccessLog: true # (Optional) Enable access logs for this list
 tailscale:
   providers:
-    default: # name of the provider
-      clientId: "asdasd" # OAuth clientId (generated by tailscale)
-      clientSecret: "asdasd" # OAuth clientSecret (generated by tailscale)
-      # if clientId and clientSecret are defined, authKey and authKeyFile are ignored
-      authKey: "" # define authkey here
-      authKeyFile: "" # use this to load authkey from file. If this is defined, Authkey is ignored
-      tags: "tag:example,tag:server" # default tags for all containers
-      # if a container is configured with tags this tag list is ignored
-      controlUrl: https://controlplane.tailscale.com # use this to override the default control URL
-  dataDir: /data/
+    default: # Name of the Tailscale provider
+      clientId: "your_client_id" # OAuth client ID (generated by Tailscale)
+      clientSecret: "your_client_secret" # OAuth client secret (generated by Tailscale)
+                                         # If clientId and clientSecret are defined, authKey 
+                                         # and authKeyFile are ignored
+      authKey: "" # Tailscale auth key (alternative to OAuth)
+      authKeyFile: "" # Path to a file containing the auth key (ignores authKey if defined)
+      tags: "tag:example,tag:server" # Default tags for all containers using this provider
+                                     # Container-specific tags override these default tags
+      controlUrl: https://controlplane.tailscale.com # Override the default Tailscale control URL
+  dataDir: /data/ # Tailscale data directory
 http:
-  hostname: 0.0.0.0
-  port: 8080
+  hostname: 0.0.0.0 # HTTP server hostname
+  port: 8080 # HTTP server port
 log:
-  level: info # set logging level info, error or trace
-  json: false # set to true to enable json logging
-proxyAccessLog: true # set to true to enable container access log
+  level: info # Logging level (info, error, debug or trace)
+  json: false # Enable JSON logging (true/false)
+proxyAccessLog: true # Enable container access logs (true/false)
 ```
 
-### log section
+### Configuration Sections
+
+#### log Section
 
-#### level
+##### level
 
-Define the logging level. The default is info.
+Defines the logging level. Options are `info`, `error`, `debug` or `trace`.
+The default is `info`.
 
-#### json
+##### json
 
-Set to true if what logging in json format.
+Enables JSON-formatted logging when set to `true`. Defaults to `false`.
 
-### tailscale section
+#### tailscale Section
 
-You can use the following options to configure Tailscale:
+Configures Tailscale integration.
 
-#### dataDir
+##### dataDir
 
-Define the data directory used by Tailscale. The default is `/data/`.
+Specifies the data directory used by Tailscale. Defaults to `/data/`.
 
-#### providers
+##### providers
 
-Here you can define multiple Tailscale providers. Each provider is configured
-with the following options:
+Defines multiple Tailscale providers. Each provider has the following options:
 
-```yaml  {filename="/config/tsdproxy.yaml"}
-   default: # name of the provider
-      authKey: your-authkey # define authkey here
-      authKeyFile: "" # use this to load authkey from file.
-      controlUrl: https://controlplane.tailscale.com 
+```yaml {filename="/config/tsdproxy.yaml"}
+  default: # Provider name
+    authKey: your-authkey # Tailscale auth key
+    authKeyFile: "" # Path to auth key file
+    controlUrl: https://controlplane.tailscale.com # Tailscale control URL
 ```
 
-Look at next example with multiple providers.
+Example with multiple providers:
 
-```yaml  {filename="/config/tsdproxy.yaml"}
+```yaml {filename="/config/tsdproxy.yaml"}
 tailscale:
   providers:
     default:
       authKey: your-authkey
       authKeyFile: ""
       controlUrl: https://controlplane.tailscale.com
- 
+
     server1:
       authKey: authkey-server1
       authKeyFile: ""
       controlUrl: http://server1
- 
+
     differentkey:
-      authKey: authkey-with-diferent-tags
+      authKey: authkey-with-different-tags
       authKeyFile: ""
       controlUrl: https://controlplane.tailscale.com
 ```
 
-TSDProxy is configured with 3 tailscale providers. Provider 'default' with tailscale
-servers, Provider 'server1' with a different tailscale server and provider 'differentkey'
-using the default tailscale server with a different authkey where you can add any
-tags.
+This example configures three Tailscale providers: `default` (default server),
+`server1` (different Tailscale server), and `differentkey` (default server with
+a different auth key for specific tags).
 
-> [!TIP]
-> Visit [Tailscale page](../advanced/tailscale/) for more details.
+> [!Tip]
+> For more details, see the [Tailscale page](../advanced/tailscale/).
 
-### docker section
+#### docker Section
 
-TSDProxy can use multiple docker servers. Each docker server can be configured
-like this:
+Configures Docker server connections. Multiple Docker servers can be defined:
 
-```yaml  {filename="/config/tsdproxy.yaml"}
-  local: # name of the docker provider
-    host: unix:///var/run/docker.sock # host of the docker socket or daemon
-    targetHostname: 172.31.0.1 # hostname or IP of docker server
-    defaultProxyProvider: default # name of which proxy provider to use
+```yaml {filename="/config/tsdproxy.yaml"}
+  local: # Docker provider name
+    host: unix:///var/run/docker.sock # Docker socket or daemon address
+    targetHostname: 172.31.0.1 # Docker server hostname or IP
+    defaultProxyProvider: default # Default proxy provider for this Docker server
 ```
 
-Look at next example of using a multiple docker servers configuration.
+Example with multiple Docker servers:
 
-```yaml  {filename="/config/tsdproxy.yaml"}
+```yaml {filename="/config/tsdproxy.yaml"}
 docker:
-  local: 
-    host: unix:///var/run/docker.sock 
-    defaultProxyProvider: default 
-  srv1: 
+  local:
+    host: unix:///var/run/docker.sock
+    defaultProxyProvider: default
+  srv1:
     host: tcp://174.17.0.1:2376
     targetHostname: 174.17.0.1
     defaultProxyProvider: server1
 ```
 
-TSDProxy is configured with a local server and a server remote 'srv1'
+This example configures a `local` Docker server and a remote `srv1` server.
 
-#### host
+##### host
 
-host is the address of the docker socket or daemon. The default is `unix:///var/run/docker.sock`
+Specifies the Docker socket or daemon address. Defaults to `unix:///var/run/docker.sock`.
 
-#### targetHostname
+##### targetHostname
 
-Is the ip address or dns name of docker server. TSDProxy has a autodetect system
-to connect with containers, but there's some cases where it's necessary to use
-the other interfaces besides the docker internals.
+Specifies the IP address or DNS name of the Docker server. Used for connecting to
+containers in specific cases.
 
-#### defaultProxyProvider
+##### defaultProxyProvider
 
-defaultProxyProvider is the name of the proxy provider to use. (defined in tailscale
-providers section). Any container defined to be proxied will use this provider
-unless it has a specific provider defined label.
+Specifies the default Tailscale provider (defined in the `tailscale.providers`
+section) to use for containers on this Docker server. Container-specific labels
+override this setting.
 
 {{% /steps %}}