restore headers for GitHub, and add deprecation notes

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

Author: thaJeztah

docs/faqs/index.md

@@ -1,11 +1,17 @@
 ---
-advisory: toolbox
 description: FAQs, troubleshooting, and tips index for Toolbox installs
 identifier: toolbox_overview_faqs
 keywords: docker, documentation, about, technology, kitematic, gui, toolbox
-title: FAQs and troubleshooting
 ---
 
+> ## Deprecation Notice :warning:
+>
+> Docker Toolbox is deprecated and is no longer in active development. Please use
+> [Docker Desktop](https://www.docker.com/products/docker-desktop) instead where
+> possible.
+
+# FAQs and Troubleshooting
+
 This is a frequently asked questions (FAQs) and troubleshooting guide for non-technical users who are learning about Docker, starting with [Docker Toolbox](https://www.docker.com/products/docker-toolbox).
 
 By following the getting started, you'll learn fundamental Docker features by performing some simple tasks.

docs/faqs/troubleshoot.md

@@ -1,10 +1,16 @@
 ---
-advisory: toolbox
 description: Troubleshooting connectivity and certificate issues
 keywords: beginner, getting started, FAQs, troubleshooting, Docker
-title: Troubleshooting
 ---
 
+> ## Deprecation Notice :warning:
+>
+> Docker Toolbox is deprecated and is no longer in active development. Please use
+> [Docker Desktop](https://www.docker.com/products/docker-desktop) instead where
+> possible.
+
+# title: Troubleshooting
+
 Typically, the QuickStart works out-of-the-box, but some scenarios can cause problems.
 
 ## Example errors

docs/index.md

@@ -1,11 +1,15 @@
 ---
-advisory: toolbox
 description: Documentation that provides an overview of Docker Toolbox and installation instructions
 keywords: docker, documentation, about, technology, docker toolbox, gui
-title: Docker Toolbox
 ---
 
-**Note** while Docker Toolbox is now considered Legacy, Kitematic is still supported and available as a separate download from [https://github.com/docker/kitematic](https://github.com/docker/kitematic)
+> ## Deprecation Notice :warning:
+>
+> Docker Toolbox is deprecated and is no longer in active development. Please use
+> [Docker Desktop](https://www.docker.com/products/docker-desktop) instead where
+> possible.
+
+# Docker Toolbox
 
 Available for both Windows and Mac, Docker Toolbox installs the Docker Client, Machine, Compose, and Kitematic.
 

docs/overview.md

@@ -1,11 +1,17 @@
 ---
-advisory: toolbox
 description: Documentation that provides an overview of Toolbox
 keywords: docker, documentation, about, technology, kitematic, gui, toolbox
-title: Docker Toolbox overview
 ---
 
-Docker Toolbox is an installer for quick setup and launch of a Docker environment on older Mac and Windows systems that do not meet the requirements of the new [Docker Desktop for Mac](../docker-for-mac/index.md) and [Docker Desktop for Windows](../docker-for-windows/index.md) apps.
+> ## Deprecation Notice :warning:
+>
+> Docker Toolbox is deprecated and is no longer in active development. Please use
+> [Docker Desktop](https://www.docker.com/products/docker-desktop) instead where
+> possible.
+
+# Docker Toolbox overview
+
+Docker Toolbox is an installer for quick setup and launch of a Docker environment on older Mac and Windows systems that do not meet the requirements of the new [Docker Desktop for Mac](https://docs.docker.com/docker-for-mac/) and [Docker Desktop for Windows](https://docs.docker.com/docker-for-windows/) apps.
 
 ![Toolbox installer](images/toolbox-installer.png)
 
@@ -36,14 +42,3 @@ Choose the install instructions for your platform, and follow the steps:
 
  - [Install Docker Toolbox for Windows](toolbox_install_windows.md)
 
-## Next steps
-
-* Try the [Get started](../get-started/index.md) tutorial.
-
-* Dig in deeper with [more tutorials and examples](../engine/tutorials/index.md) on building images, running containers, networking, managing data, and storing images on Docker Hub.
-
-* [Learn about Kitematic](../kitematic/userguide.md)
-
-* [Learn about Docker Machine](../machine/overview.md)
-
-* [Learn about Docker Compose](../compose/index.md)

docs/toolbox_install_mac.md

@@ -1,13 +1,18 @@
 ---
-advisory: toolbox
 description: How to install Toolbox on Mac
 keywords: docker, documentation, install, toolbox, mac
-title: Install Docker Toolbox on macOS
 ---
 
+# Install Docker Toolbox on macOS
+
+> ### Deprecation Notice: Docker Toolbox is deprecated
+>
+> and is no longer in active development. Please use Docker Desktop instead where
+> possible. [Docker Desktop](https://www.docker.com/products/docker-desktop)
+
 Docker Toolbox provides a way to use Docker on older Macs
 that do not meet
-minimal system requirements for [Docker Desktop for Mac](../docker-for-mac/index.md).
+minimal system requirements for [Docker Desktop for Mac](https://docs.docker.com/docker-for-mac/).
 
 ## What you get and how it works
 
@@ -28,7 +33,7 @@ attach to a small Linux VM on your machine. This VM hosts
 Docker Engine for you on your Mac.
 
 >**Tip**: One of the advantages of the newer
-[Docker Desktop for Mac](../docker-for-mac/index.md) solution is that
+[Docker Desktop for Mac](https://docs.docker.com/docker-for-mac/) solution is that
 it uses native virtualization and does not require
 VirtualBox to run Docker.
 
@@ -275,7 +280,7 @@ To uninstall Toolbox on a Mac, do the following:
 
  This step is optional because if you plan
  to re-install Docker Machine as a part
- of [Docker Desktop for Mac](../docker-for-mac/index.md), you can import and
+ of [Docker Desktop for Mac](https://docs.docker.com/docker-for-mac/), you can import and
  continue to manage those machines through Docker.
 
 3. In your "Applications" folder, remove the "Docker" directory,
@@ -305,15 +310,3 @@ To uninstall Toolbox on a Mac, do the following:
 
 7. Uninstall Oracle VirtualBox, which is installed as a part of the
  Toolbox install.
-
-## Next steps
-
-* Try the [Get started](../get-started/index.md) tutorial.
-
-* Dig in deeper with [more tutorials and examples](../engine/tutorials/index.md) on building images, running containers, networking, managing data, and storing images on Docker Hub.
-
-* [Learn about Kitematic](../kitematic/userguide.md)
-
-* [Learn about Docker Machine](../machine/overview.md)
-
-* [Learn about Docker Compose](../compose/index.md)

docs/toolbox_install_windows.md

@@ -1,12 +1,17 @@
 ---
-advisory: toolbox
 description: How to install Toolbox on Mac
 keywords: docker, documentation, install, toolbox, win
-title: Install Docker Toolbox on Windows
 ---
 
+# Install Docker Toolbox on Windows
+
+> ### Deprecation Notice: Docker Toolbox is deprecated
+>
+> and is no longer in active development. Please use Docker Desktop instead where
+> possible. [Docker Desktop](https://www.docker.com/products/docker-desktop)
+
 Docker Toolbox provides a way to use Docker on Windows systems that do not meet
-minimal system requirements for the [Docker Desktop for Windows](../docker-for-windows/index.md)
+minimal system requirements for the [Docker Desktop for Windows](https://docs.docker.com/docker-for-windows/)
 app.
 
 ## What you get and how it works
@@ -28,7 +33,7 @@ small Linux VM on your machine. This VM hosts Docker Engine
 for you on your Windows system.
 
 >**Tip**: One of the advantages of the newer
-[Docker Desktop for Windows](../docker-for-windows/index.md) solution is that
+[Docker Desktop for Windows](https://docs.docker.com/docker-for-windows/) solution is that
 it uses native virtualization and does not require
 VirtualBox to run Docker.
 
@@ -43,13 +48,13 @@ To verify your machine meets these requirements, do the following:
  operating system.
 
  If you have a recent version of Windows,
- consider using [Docker Desktop for Windows](/docker-for-windows) instead. It runs
+ consider using [Docker Desktop for Windows](https://docs.docker.com/docker-for-windows/) instead. It runs
  natively on the Windows, so there is no need for a pre-configured Docker
  QuickStart shell. It also uses Hyper-V for virtualization, so the
  instructions below for checking virtualization will be out of date for newer
  Windows systems. Full install prerequisites are provided in the Docker Desktop for
  Windows topic in [What to know before you
- install](/docker-for-windows/#what-to-know-before-you-install).
+ install](https://docs.docker.com/docker-for-windows/#what-to-know-before-you-install).
 
 2. Make sure your Windows system supports Hardware Virtualization Technology and that virtualization is enabled.
 
@@ -249,7 +254,7 @@ To uninstall Toolbox on Windows, do the following:
  ```
 
  This step is optional because if you plan to re-install Docker Machine as a
- part of [Docker Desktop for Windows](../docker-for-windows/index.md), you can
+ part of [Docker Desktop for Windows](https://docs.docker.com/docker-for-windows/), you can
  import and continue to manage those machines through Docker.
 
 3. Uninstall Docker Toolbox using Window's standard process for uninstalling programs through the control panel (programs and features).
@@ -271,14 +276,3 @@ To uninstall Toolbox on Windows, do the following:
 6. Uninstall Oracle VirtualBox, which is
  installed as a part of the Toolbox install.
 
-## Next steps
-
-* Try out the [Get started](../get-started/index.md) tutorial.
-
-* Dig in deeper with [more tutorials and examples](../engine/tutorials/index.md) on building images, running containers, networking, managing data, and storing images on Docker Hub.
-
-* [Learn about Kitematic](../kitematic/userguide.md)
-
-* [Learn about Docker Machine](../machine/overview.md)
-
-* [Learn about Docker Compose](../compose/index.md)