Language and clarification tweaks

scout/advanced-image-analysis.md

@@ -20,7 +20,7 @@ vulnerability report.
 The **General** tab of an image page on Docker Hub shows a summary of common vulnerabilities and
 exposures (CVEs) for the image in the **Tags** section. The **Tags** tab shows all analysis results.
 
-The **Images** section of Docker Desktop shows an overview of CVEs for an image and the details view shows all ulnerabilities.
+The **Images** section of Docker Desktop shows an overview of CVEs for an image and the details view shows all vulnerabilities.
 
 Advanced image analysis supports the following package ecosystems:
 
@@ -39,7 +39,7 @@ Advanced image analysis supports the following package ecosystems:
 
 ## Activate Advanced image analysis
 
-Advanced image analysis is an early access feature. It can be activated on a
+Advanced image analysis is an early access feature and activated on a
 per-repository basis for organizations with a
 [Docker Pro, Team, or Business subscription](../subscription/index.md).
 
@@ -60,10 +60,10 @@ To activate Advanced image analysis:
 
 ## Analyze an image
 
-To trigger Advanced image analysis, push the image to a Docker Hub repository
-where Advanced image analysis is active:
+To trigger Advanced image analysis, push an image to a Docker Hub repository
+with Advanced image analysis active:
 
-1. Sign in to your Docker ID, either using the `docker login` command or the
+1. Sign in with your Docker ID, either using the `docker login` command or the
    **Sign in** button in Docker Desktop.
 2. Tag the image to analyze. For example, to tag a Redis image, run:
 
@@ -81,28 +81,25 @@ where Advanced image analysis is active:
 
 To view the vulnerability report on Docker Hub:
 
-1. Go to Docker Hub and open the repository page. A vulnerability summary is
-   available in the **Tags** section of the page.
+1. Go to Docker Hub and open the repository page. The **Tags** section
+   displays a vulnerability summary.
 
-   It may take a few minutes for the vulnerability report to appear in your
-   repository. If your vulnerability summary doesn't display yet, wait a moment
+   It may take a few minutes for the vulnerability report to appear. If your vulnerability summary doesn't display, wait a moment
    and then refresh the page.
 
 2. Click on the tag in the table. This opens the details page for the tag.
 
 3. Select the **Vulnerabilities** tab on the right side of the page.
 
-   This tab displays a deep-dive view of your vulnerability exposure. If your
-   image contains packages known to be affected by vulnerabilities, those
-   packages show up here.
+   This tab displays a deep-dive view of the image's packages and any known vulnerabilities.
 
    For more information about how to interpret the vulnerability report, see
    [Image details view](./image-details-view.md)
 
 Expanding any of the packages in the list shows you more information about the
-vulnerabilities that affect a given package. Clicking on the hyperlink of a
-vulnerability opens it in Docker's image vulnerability database, which provides
-even more information on the vulnerability and what images it affects.
+vulnerabilities that affect a given package. Expanding the vulnerability shows a summary of it's details and
+clicking on the vulnerability name opens Docker's image vulnerability database, which provides
+more information on the vulnerability and what images it affects.
 
 ## Deactivate Advanced image analysis
 
@@ -117,11 +114,10 @@ To deactivate Advanced image analysis:
 2. Select **Repositories** from the main menu and select a repository from the
    list.
 3. Go to the **Settings** tab.
-4. Under **Image insight settings**, and select one of the following options:
+4. Under **Image insight settings**, select one of the following options:
 
-   - **None** if you want to completely turn off vulnerability detection
-   - **Hub vulnerability scanning** if you want to use the basic scanning
-     feature.
+   - **Basic Hub vulnerability scanning** to use the basic scanning feature.
+   - **None** to turn off vulnerability detection.
 
 5. Select **Save**.
 

scout/index.md

@@ -22,7 +22,7 @@ Docker Scout is a collection of software supply chain features that appear
 throughout Docker user interfaces and the command line interface (CLI). These features provide detailed
 insights into the composition and security of container images.
 
-Docker Scout analyzes the image contents and generates a detailed report of
+Docker Scout analyzes image contents and generates a detailed report of
 packages and vulnerabilities that it detects. Docker Scout can also help provide
 you with suggestions for how you can remediate issues discovered by the image
 analysis.
@@ -40,10 +40,10 @@ images, packages, and CVEs.
 
 ## Get started with Docker Scout
 
-To start using Docker Scout, enable any of the following features:
+To start using Docker Scout, turn on any of the following features:
 
-- Advanced image analysis in Docker Hub
-- Artifactory integration
+- [Advanced image analysis in Docker Hub](./advanced-image-analysis.md)
+- [Artifactory integration](./artifactory.md)
 
 Enabling either feature requires a paid Docker subscription. Once enabled,
 Docker Scout is activated for your organization automatically.