Merge pull request #74 from docker/cli-install-in-wsl2

Add WSL2 instructions for CLI install

Author: gtardif

README.md

@@ -6,6 +6,10 @@ This repository includes Desktop Extension samples.
 
 :warning: **This work is experimental and still in progress, features and APIs detailed are subject to change**
 
+## Documentation
+
+The documentation is published and best viewed at https://docker-desktop-extensions.netlify.app/.
+
 ## Prerequisites
 
 To get started with Docker Extensions you will need a specific Docker Desktop build that comes with extension capabilities and the Extensions CLI.

docs/index.md

@@ -27,25 +27,54 @@ Go to the [releases page](https://github.com/docker/desktop-extension-samples/re
 
 Once you've downloaded Extensions CLI, you need to extract the binary into `~/.docker/cli-plugins`.
 
-For macOS:
+=== ":fontawesome-brands-apple: MacOS (intel)"
 
-```console
-tar -xvzf desktop-extension-cli-darwin-amd64.tar.gz
-chmod +x docker-extension
-mkdir -p ~/.docker/cli-plugins
-mv docker-extension ~/.docker/cli-plugins
-```
+    In a terminal, run:
 
-!!! info
+    ```console
+    tar -xvzf desktop-extension-cli-darwin-amd64.tar.gz
+    chmod +x docker-extension
+    mkdir -p ~/.docker/cli-plugins
+    mv docker-extension ~/.docker/cli-plugins
+    ```
 
-    When running the Extensions CLI on macOS you'll see the message: _"docker-extension" cannot be opened because the developer cannot be verified."_ At the moment, the Extensions CLI is not signed by Docker (yet) and you'll need to trust the binary by going to `System Preferences` > `Security & Privacy` > (General tab) click on `Allow Anyway`.
+    !!! info
 
-For Windows:
+        When running the Extensions CLI on macOS you'll see the message: _"docker-extension" cannot be opened because the developer cannot be verified."_ At the moment, the Extensions CLI is not signed by Docker (yet) and you'll need to trust the binary by going to `System Preferences` > `Security & Privacy` > (General tab) click on `Allow Anyway`.
 
-```console
-tar -xvzf desktop-extension-cli-windows-amd64.tar.gz
-mkdir -p ~/.docker/cli-plugins
-mv docker-extension.exe ~/.docker/cli-plugins
-```
+=== ":fontawesome-brands-apple: MacOS (arm)"
 
-You can now enable the extension feature by running `docker extension enable`
+    In a terminal, run:
+
+    ```console
+    tar -xvzf desktop-extension-cli-darwin-arm64.tar.gz
+    chmod +x docker-extension
+    mkdir -p ~/.docker/cli-plugins
+    mv docker-extension ~/.docker/cli-plugins
+    ```
+
+    !!! info
+
+        When running the Extensions CLI on macOS you'll see the message: _"docker-extension" cannot be opened because the developer cannot be verified."_ At the moment, the Extensions CLI is not signed by Docker (yet) and you'll need to trust the binary by going to `System Preferences` > `Security & Privacy` > (General tab) click on `Allow Anyway`.
+
+=== ":fontawesome-brands-windows: Windows"
+
+    In a PowerShell terminal, run:
+
+    ```powershell
+    tar -xvzf desktop-extension-cli-windows-amd64.tar.gz
+    mkdir -p ~/.docker/cli-plugins
+    mv docker-extension.exe ~/.docker/cli-plugins
+    ```
+
+=== ":fontawesome-brands-windows: :fontawesome-brands-linux: WSL2"
+
+    In a WSL2 terminal, run:
+
+    ```console
+    tar -xvzf desktop-extension-cli-linux-amd64.tar.gz
+    mkdir -p ~/.docker/cli-plugins
+    mv docker-extension ~/.docker/cli-plugins
+    ```
+
+You can now enable the extension feature by running `docker extension enable`.

mkdocs.yml

@@ -18,6 +18,7 @@ theme:
     - navigation.sections
     - toc.integrate
     - content.code.annotate
+    - content.tabs.link
 extra:
   generator: false
 copyright: Copyright © 2021 Docker, Inc.
@@ -35,7 +36,8 @@ markdown_extensions:
   - pymdownx.emoji:
       emoji_index: !!python/name:materialx.emoji.twemoji
       emoji_generator: !!python/name:materialx.emoji.to_svg
-
+  - pymdownx.tabbed:
+      alternate_style: true
 nav:
   - Introduction: index.md
   - Tutorials: