diff --git a/docs/content/migration/v2-to-v3.md b/docs/content/migration/v2-to-v3.md
index b4cf1bafd..b9a2fd769 100644
--- a/docs/content/migration/v2-to-v3.md
+++ b/docs/content/migration/v2-to-v3.md
@@ -83,7 +83,7 @@ In v3, the Marathon provider has been removed.
 
 In v3, the InfluxDB v1 metrics provider has been removed because InfluxDB v1.x maintenance [ended in 2021](https://www.influxdata.com/blog/influxdb-oss-and-enterprise-roadmap-update-from-influxdays-emea/).
 
-### Kubernetes CRDs API Group `traefik.containo.us`
+## Kubernetes CRDs API Group `traefik.containo.us`
 
 In v3, the Kubernetes CRDs API Group `traefik.containo.us` has been removed. 
 Please use the API Group `traefik.io` instead.
@@ -95,13 +95,13 @@ In v3, the provider Docker has been split into 2 providers:
 - Docker provider (without Swarm support)
 - Swarm provider  (Swarm support only)
 
-### Kubernetes Ingress API Group `networking.k8s.io/v1beta1`
+## Kubernetes Ingress API Group `networking.k8s.io/v1beta1`
 
 In v3, the Kubernetes Ingress API Group `networking.k8s.io/v1beta1` ([removed since Kubernetes v1.22](https://kubernetes.io/docs/reference/using-api/deprecation-guide/#ingress-v122)) support has been removed.
 
 Please use the API Group `networking.k8s.io/v1` instead.
 
-### Traefik CRD API Version `apiextensions.k8s.io/v1beta1`
+## Traefik CRD API Version `apiextensions.k8s.io/v1beta1`
 
 In v3, the Traefik CRD API Version `apiextensions.k8s.io/v1beta1` ([removed since Kubernetes v1.22](https://kubernetes.io/docs/reference/using-api/deprecation-guide/#customresourcedefinition-v122)) support has been removed.
 
diff --git a/docs/content/providers/swarm.md b/docs/content/providers/swarm.md
index 96c987c87..416583281 100644
--- a/docs/content/providers/swarm.md
+++ b/docs/content/providers/swarm.md
@@ -407,31 +407,7 @@ providers:
 # ...
 ```
 
-### `swarmMode`
-
-_Optional, Default=false_
-
-Enables the Swarm Mode (instead of standalone Docker).
-
-```yaml tab="File (YAML)"
-providers:
-  swarm:
-    swarmMode: true
-    # ...
-```
-
-```toml tab="File (TOML)"
-[providers.swarm]
-  swarmMode = true
-  # ...
-```
-
-```bash tab="CLI"
---providers.swarm.swarmMode=true
-# ...
-```
-
-### `swarmModeRefreshSeconds`
+### `refreshSeconds`
 
 _Optional, Default=15_
 
@@ -440,18 +416,18 @@ Defines the polling interval (in seconds) for Swarm Mode.
 ```yaml tab="File (YAML)"
 providers:
   swarm:
-    swarmModeRefreshSeconds: 30
+    refreshSeconds: 30
     # ...
 ```
 
 ```toml tab="File (TOML)"
 [providers.swarm]
-  swarmModeRefreshSeconds = 30
+  refreshSeconds = 30
   # ...
 ```
 
 ```bash tab="CLI"
---providers.swarm.swarmModeRefreshSeconds=30
+--providers.swarm.refreshSeconds=30
 # ...
 ```