Improve documentation about API and Dashboard.

docs/content/getting-started/quick-start.md

@@ -17,11 +17,11 @@ services:
     # The official v2.0 Traefik docker image
     image: traefik:v2.0
     # Enables the web UI and tells Traefik to listen to docker
-    command: --api --providers.docker
+    command: --api.insecure=true --providers.docker
     ports:
       # The HTTP port
       - "80:80"
-      # The Web UI (enabled by --api)
+      # The Web UI (enabled by --api.insecure=true)
       - "8080:8080"
     volumes:
       # So that Traefik can listen to the Docker events

docs/content/includes/.markdownlint.json

@@ -1,4 +0,0 @@
-{
-    "extends": "../../.markdownlint.json",
-    "MD041": false
-}

docs/content/includes/more-on-command-line.md

@@ -1 +0,0 @@
-To learn more about configuration options in the command line, refer to the [configuration overview](../getting-started/configuration-overview.md)

docs/content/includes/more-on-configuration-file.md

@@ -1 +0,0 @@
-To learn more about the configuration file, refer to [configuration overview](../getting-started/configuration-overview.md)

docs/content/includes/more-on-entrypoints.md

@@ -1,2 +0,0 @@
-!!! info "More On Entry Points"
-    Learn more about entry points and their configuration options in the dedicated section.

docs/content/includes/more-on-key-value-store.md

@@ -1 +0,0 @@
-To learn more about configuration in key-value stores, refer to the [configuration overview](../getting-started/configuration-overview.md)

docs/content/includes/more-on-routers.md

@@ -1,2 +0,0 @@
-!!! info "More On Routers"
-    Learn more about routers and their configuration options in the [dedicated section](../routing/routers/index.md).

docs/content/operations/dashboard.md

@@ -12,13 +12,13 @@ The dashboard is the central place that shows you the current active routes hand
 
 By default, the dashboard is available on `/` on port `:8080`.
 
-!!! tip "Did You Know?"
+!!! note "Did You Know?"
     It is possible to customize the dashboard endpoint. 
     To learn how, refer to the [API documentation](./api.md)
     
 ## Enabling the Dashboard
 
-To enable the dashboard, you need to enable Traefik's API.
+To enable the dashboard, you need to enable [Traefik's API](./api.md).
 
 ```toml tab="File (TOML)"
 [api]
@@ -49,10 +49,12 @@ api:
 --api.dashboard=true
 ```
 
-{!more-on-command-line.md!}
+!!! important "API/Dashboard Security" 
+    
+    To secure your dashboard, the use of a `service` named `api@internal` is mandatory and requires the definition of a router using one or more security [middlewares](../middlewares/overview.md)
+    like authentication ([basicAuth](../middlewares/basicauth.md) , [digestAuth](../middlewares/digestauth.md), [forwardAuth](../middlewares/forwardauth.md)) or [whitelisting](../middlewares/ipwhitelist.md).  
+    More information about `api@internal` can be found in the [API documentation](./api.md#configuration)
 
-{!more-on-configuration-file.md!}
+!!! note "Did You Know?"
-
-!!! tip "Did You Know?"
     The API provides more features than the Dashboard. 
     To learn more about it, refer to the [API documentation](./api.md)

docs/content/user-guides/crd-acme/03-deployments.yml

@@ -28,7 +28,7 @@ spec:
         - name: traefik
           image: traefik:v2.0
           args:
-            - --api
+            - --api.insecure
             - --accesslog
             - --entrypoints.web.Address=:8000
             - --entrypoints.websecure.Address=:4443

docs/content/user-guides/docker-compose/acme-dns/docker-compose.yml

@@ -3,11 +3,11 @@ version: "3.3"
 services:
 
   traefik:
-    image: "traefik:v2.0.0-beta1"
+    image: "traefik:v2.0.0-rc3"
     container_name: "traefik"
     command:
       #- "--log.level=DEBUG"
-      - "--api=true"
+      - "--api.insecure=true"
       - "--providers.docker=true"
       - "--providers.docker.exposedbydefault=false"
       - "--entrypoints.web.address=:80"

docs/content/user-guides/docker-compose/acme-dns/docker-compose_secrets.yml

@@ -13,11 +13,11 @@ secrets:
 services:
 
   traefik:
-    image: "traefik:v2.0.0-beta1"
+    image: "traefik:v2.0.0-rc3"
     container_name: "traefik"
     command:
       #- "--log.level=DEBUG"
-      - "--api=true"
+      - "--api.insecure=true"
       - "--providers.docker=true"
       - "--providers.docker.exposedbydefault=false"
       - "--entrypoints.web.address=:80"

docs/content/user-guides/docker-compose/acme-http/docker-compose.yml

@@ -3,11 +3,11 @@ version: "3.3"
 services:
 
   traefik:
-    image: "traefik:v2.0.0-beta1"
+    image: "traefik:v2.0.0-rc3"
     container_name: "traefik"
     command:
       #- "--log.level=DEBUG"
-      - "--api=true"
+      - "--api.insecure=true"
       - "--providers.docker=true"
       - "--providers.docker.exposedbydefault=false"
       - "--entrypoints.web.address=:80"

docs/content/user-guides/docker-compose/acme-tls/docker-compose.yml

@@ -3,11 +3,11 @@ version: "3.3"
 services:
 
   traefik:
-    image: "traefik:v2.0.0-beta1"
+    image: "traefik:v2.0.0-rc3"
     container_name: "traefik"
     command:
       #- "--log.level=DEBUG"
-      - "--api=true"
+      - "--api.insecure=true"
       - "--providers.docker=true"
       - "--providers.docker.exposedbydefault=false"
       - "--entrypoints.websecure.address=:443"

docs/content/user-guides/docker-compose/basic-example/docker-compose.yml

@@ -3,11 +3,11 @@ version: "3.3"
 services:
 
   traefik:
-    image: "traefik:v2.0.0-beta1"
+    image: "traefik:v2.0.0-rc3"
     container_name: "traefik"
     command:
       #- "--log.level=DEBUG"
-      - "--api=true"
+      - "--api.insecure=true"
       - "--providers.docker=true"
       - "--providers.docker.exposedbydefault=false"
       - "--entrypoints.web.address=:80"

docs/content/user-guides/docker-compose/basic-example/index.md

@@ -53,7 +53,7 @@ ports:
 ```yaml
 command:
   # Traefik will listen on port 8080 by default for API request.
-  - "--api=true"
+  - "--api.insecure=true"
 
 ports:
   - "8080:8080"

docs/content/user-guides/grpc.md

@@ -34,7 +34,7 @@ api: {}
 ```yaml tab="CLI"
 --entryPoints.web.address=":80"
 --providers.file.filename=dynamic_conf.toml
---api=true
+--api.insecure=true
 ```
 
 `dynamic_conf.{toml,yml}`:
@@ -157,7 +157,7 @@ api: {}
 # For secure connection on backend.local
 --serversTransport.rootCAs=./backend.cert
 --providers.file.filename=dynamic_conf.toml
---api=true
+--api.insecure=true
 ```
 
 `dynamic_conf.{toml,yml}`:

docs/mkdocs.yml

@@ -58,9 +58,9 @@ markdown_extensions:
   - pymdownx.tasklist
   - pymdownx.snippets:
       check_paths: true
-  - markdown_include.include:
+#  - markdown_include.include:
-      base_path: content/includes/
+#      base_path: content/includes/
-      encoding: utf-8
+#      encoding: utf-8
   - toc:
       permalink: true