ENGDOCS-835: DD refining (#15202)

* ENGDOCS-835: DD refining

* moved content around

_data/toc.yaml

@@ -1167,6 +1167,8 @@ manuals:
           title: Explore Images
         - path: /desktop/use-desktop/volumes/
           title: Explore Volumes
+        - path: /desktop/use-desktop/pause/
+          title: Pause Docker Desktop
     - sectiontitle: Change settings
       section:
         - path: /desktop/settings/mac/

desktop/get-started.md

@@ -112,17 +112,3 @@ Digest: sha256:3c6b73ce467f04d4897d7a7439782721fd28ec9bf62ea2ad9e81a5fb7fb3ff96
 Status: Downloaded newer image for molly/privateimage:latest
 docker.io/molly/privateimage:latest
 ```
-
-## Pause or resume Docker Desktop
-
-You can pause your Docker Desktop session when you are not actively using it and save CPU resources on your machine. When you pause Docker Desktop, the Linux VM running Docker Engine is paused, the current state of all your containers are saved in memory, and all processes are frozen. This reduces the CPU usage and helps you retain a longer battery life on your laptop. You can resume Docker Desktop when you want by clicking the **Resume** option.
-
-From the Docker menu, select![whale menu](images/whale-x.png){: .inline} and then **Pause** to pause Docker Desktop.
-
-Docker Desktop displays the paused status on the Docker menu and on the  **Containers**, **Images**, **Volumes**, and **Dev Environment** screens in Docker Dashboard. You can still access the **Preferences** (or **Settings** if you are a Windows user) and the **Troubleshoot** menu from the Dashboard when you've paused Docker Desktop.
-
-Select ![whale menu](images/whale-x.png){: .inline} then **Resume** to resume Docker Desktop.
-
-> **Note**
->
-> When Docker Desktop is paused, running any commands in the Docker CLI will automatically resume Docker Desktop.

desktop/index.md

@@ -1,7 +1,7 @@
 ---
 description: Docker Desktop overview
 keywords: Desktop, Docker, GUI, run, docker, local, machine, dashboard
-title: Docker Desktop overview
+title: Docker Desktop
 redirect_from:
 - /desktop/opensource/
 - /docker-for-mac/opensource/
@@ -28,7 +28,7 @@ Docker Desktop includes:
 - [Docker Compose](../compose/index.md)
 - [Docker Content Trust](../engine/security/trust/index.md)
 - [Kubernetes](https://github.com/kubernetes/kubernetes/)
-- [Credential Helper](https://github.com/docker/docker-credential-helpers/).
+- [Credential Helper](https://github.com/docker/docker-credential-helpers/)
 
 Docker Desktop works with your choice of development tools and languages and
 gives you access to a vast library of certified images and templates in
@@ -44,7 +44,7 @@ When you open Docker Desktop, the Docker Dashboard displays.
 
 The **Containers** view provides a runtime view of all your containers and applications. It allows you to interact with containers and applications, and manage the lifecycle of your applications directly from your machine. This view also provides an intuitive interface to perform common actions to inspect, interact with, and manage your Docker objects including containers and Docker Compose-based applications. For more information, see [Explore running containers and applications](use-desktop/container.md).
 
-The **Images** view displays a list of your Docker images and allows you to run an image as a container, pull the latest version of an image from Docker Hub, and inspect images. It also displays a summary of the vulnerability scanning report using Snyk. In addition, the **Images** view contains clean-up options to remove unwanted images from the disk to reclaim space. If you are logged in, you can also see the images you and your organization have shared on Docker Hub. For more information, see [Explore your images](use-desktop/images.md)
+The **Images** view displays a list of your Docker images and allows you to run an image as a container, pull the latest version of an image from Docker Hub, and inspect images. It also displays a summary of the vulnerability scanning report using Snyk. In addition, the **Images** view contains clean-up options to remove unwanted images from the disk to reclaim space. If you are logged in, you can also see the images you and your organization have shared on Docker Hub. For more information, see [Explore your images](use-desktop/images.md).
 
 The **Volumes** view displays a list of volumes and allows you to easily create and delete volumes and see which ones are being used. For more information, see [Explore volumes](use-desktop/volumes.md).
 

desktop/troubleshoot/known-issues.md

@@ -3,8 +3,6 @@ description: Known issues for Mac
 keywords: mac, troubleshooting, known issues
 title: Known issues for Docker Desktop on Mac
 ---
-## Known issues
-
 * The following issues are seen when using the `virtualization.framework` experimental feature:
 
   * Some VPN clients can prevent the VM running Docker from communicating with the host, preventing Docker Desktop starting correctly. See [docker/for-mac#5208](https://github.com/docker/for-mac/issues/5208).

desktop/troubleshoot/overview.md

@@ -215,7 +215,7 @@ $ /usr/bin/log show --debug --info --style syslog --last 1d --predicate "$pred"
 
 ### In the Console app
 
-Mac provides a built-in log viewer, named "Console", which you can use to check
+Mac provides a built-in log viewer, named **Console**, which you can use to check
 Docker logs.
 
 The Console lives in `/Applications/Utilities`. You can search for it with
@@ -254,7 +254,11 @@ to learn how to view the Docker Daemon logs.
 
 </div></div>
 
-
+## What's next?
+
+- View [Troubleshoot topics](topics.md).
+- Implement [workarounds for common problems](workarounds.md)
+- If you're a Mac user, see [Known issues for Mac](known-issues.md)
 
 
 

desktop/use-desktop/container.md

@@ -21,7 +21,7 @@ When you hover over individual containers, you can also:
 - Click **Open in Visual Studio Code** to open the application in VS Code.
 - Open the port exposed by the container in a browser.
 
-### Inspect a container
+## Inspect a container
 
 You can obtain detailed information about the container when you select a container.
 

desktop/use-desktop/pause.md

@@ -0,0 +1,17 @@
+---
+description: Pause Docker Dashboard
+keywords: Docker Dashboard, manage, containers, gui, dashboard, images, user manual
+title: Pause Docker Desktop
+---
+
+You can pause your Docker Desktop session when you are not actively using it and save CPU resources on your machine. When you pause Docker Desktop, the Linux VM running Docker Engine is paused, the current state of all your containers are saved in memory, and all processes are frozen. This reduces the CPU usage and helps you retain a longer battery life on your laptop. You can resume Docker Desktop when you want by clicking the **Resume** option.
+
+From the Docker menu, select![whale menu](../images/whale-x.png){: .inline} and then **Pause** to pause Docker Desktop.
+
+Docker Desktop displays the paused status on the Docker menu and on the  **Containers**, **Images**, **Volumes**, and **Dev Environment** screens in Docker Dashboard. You can still access the **Preferences** (or **Settings** if you are a Windows user) and the **Troubleshoot** menu from the Dashboard when you've paused Docker Desktop.
+
+Select ![whale menu](../images/whale-x.png){: .inline} then **Resume** to resume Docker Desktop.
+
+> **Note**
+>
+> When Docker Desktop is paused, running any commands in the Docker CLI will automatically resume Docker Desktop.

desktop/use-desktop/volumes.md

@@ -31,7 +31,7 @@ The **Data** tab displays the files and folders in the volume and the file size.
 
 To delete a file or a folder from the volume, select **Remove** from the **More options** menu.
 
-### Remove a volume
+## Remove a volume
 
 Removing a volume deletes the volume and all its data.