-* [Create and manage teams & organizations](orgs.md)
+* [Create and manage teams and organizations](orgs.md)
* [Create a company](creating-companies.md)
* [Enforce sign in](configure-sign-in.md)
* Set up [SSO](../single-sign-on/index.md) and [SCIM](scim.md)
* Use [Group mapping](group-mapping.md)
* [Carry out domain audits](domain-audit.md)
* [Use Image Access Management](image-access-management.md) to control developers' access to certain types of images
-* [Enable Registry Access Management](../desktop/hardened-desktop/registry-access-management.md)
+* [Turn on Registry Access Management](../desktop/hardened-desktop/registry-access-management.md)
@@ -70,7 +70,7 @@ GitHub and Bitbucket and push them to Docker Hub.
diff --git a/docker-hub/insights-analytics.md b/docker-hub/insights-analytics.md
index b3ac2d1b62..bd2a101a8f 100644
--- a/docker-hub/insights-analytics.md
+++ b/docker-hub/insights-analytics.md
@@ -1,16 +1,13 @@
---
title: Insights and analytics
-description: Provides usage statistics of your images on Docker Hub.
+description: Discover how to access usage statistics of your images on Docker Hub
keywords: docker hub, hub, insights, analytics, api, verified publisher
redirect_from:
- /docker-hub/publish/insights-analytics/
---
Insights and analytics provides usage analytics for Docker Verified
-Publisher (DVP) and Docker-Sponsored Open Source (DSOS) images on Docker Hub, providing self-serve access
-to metrics as both raw data and summary data for a desired time span. You can
-view the number of image pulls by tag or by digest, and get breakdowns by
-geolocation, cloud provider, client, and more.
+Publisher (DVP) and Docker-Sponsored Open Source (DSOS) images on Docker Hub. This includes self-serve access to metrics as both raw data and summary data for a desired time span. You can view the number of image pulls by tag or by digest, and get breakdowns by geolocation, cloud provider, client, and more.
> **Tip**
@@ -45,7 +42,7 @@ To view data in the chart:
### Share analytics data
-You can share the visualization with others using the share icon above the chart.
+You can share the visualization with others using the **Share** icon above the chart.
This is a convenient way to share statistics with others in your organization.
diff --git a/docker-hub/quickstart.md b/docker-hub/quickstart.md
index f922c8db10..5f8569d32a 100644
--- a/docker-hub/quickstart.md
+++ b/docker-hub/quickstart.md
@@ -1,5 +1,5 @@
---
-description: Docker Hub Quickstart
+description: Learn how to get started using Docker Hub
keywords: Docker, docker, registry, accounts, plans, Dockerfile, Docker Hub, accounts, organizations, repositories, groups, teams
title: Docker Hub Quickstart
redirect_from:
@@ -82,7 +82,7 @@ The following section contains step-by-step instructions on how to get started w
Start by creating a [Docker ID](https://hub.docker.com/signup){: target="_blank" rel="noopener" class="_"}.
-A Docker ID grants you access to Docker Hub repositories and allows you to explore images that are available from the community and verified publishers. You'll also need a Docker ID to share images on Docker Hub.
+A Docker ID grants you access to Docker Hub repositories and lets you explore available images from the community and verified publishers. You also need a Docker ID to share images on Docker Hub.
### Step 2: Create your first repository
diff --git a/docker-hub/repos/access/index.md b/docker-hub/repos/access/index.md
index f55d0acaf2..431e6e4922 100644
--- a/docker-hub/repos/access/index.md
+++ b/docker-hub/repos/access/index.md
@@ -1,5 +1,5 @@
---
-description: Access repositories on Docker Hub
+description: Discover how to access repositories on Docker Hub
keywords: Docker, docker, trusted, registry, accounts, plans, Dockerfile, Docker Hub, webhooks, docs, documentation, collaborators, viewing, searching, starring
title: Access repositories
---
@@ -36,7 +36,7 @@ To delete a tag, select the corresponding checkbox and select **Delete** from th
> Only a user with administrative access (owner or team member with Admin
> permission) over the repository can delete tags.
-You can select a tag's digest to view more details.
+You can select a tag's digest to access more details.
Image sizes are the cumulative space taken up by the image and all its parent
images. This is also the disk space used by the contents of the `.tar` file
@@ -59,7 +59,7 @@ tutum/centos Centos image with SSH access. For the root.
...
```
-In the example above, you can see two example results, `centos` and `ansible/centos7-ansible`.
+In the previous example, you can see two example results, `centos` and `ansible/centos7-ansible`.
The second result shows that it comes from the public repository of a user,
named `ansible/`, while the first result, `centos`, doesn't explicitly list a
diff --git a/docker-hub/repos/create.md b/docker-hub/repos/create.md
index 5cdff4594a..6563b60126 100644
--- a/docker-hub/repos/create.md
+++ b/docker-hub/repos/create.md
@@ -1,5 +1,5 @@
---
-description: Creating repositories on Docker Hub
+description: Learn how to create repositories on Docker Hub
keywords: Docker, docker, trusted, registry, accounts, plans, Dockerfile, Docker Hub, webhooks, docs, documentation, manage, repos
title: Create repositories
toc_max: 3
@@ -10,8 +10,7 @@ redirect_from:
Repositories let you share container images with your team,
customers, or the Docker community at large.
-A single Docker Hub repository can hold many Docker images which are stored as **tags**. Docker images are pushed to Docker Hub through the [`docker push`](/engine/reference/commandline/push/)
-command.
+A single Docker Hub repository can hold many Docker images which are stored as **tags**. You can push Docker images to Docker Hub with the [`docker push`](/engine/reference/commandline/push/)command.
## Create a repository
@@ -24,7 +23,7 @@ When creating a new repository:
- You can choose to locate it under your own user account, or under any
[organization](../../docker-hub/orgs.md) where you are an [owner](../manage-a-team.md#organization-owner).
- The repository name needs to:
- - Be unique
+ - Be unique
- Have between 2 and 255 characters
- Only contain lowercase letters, numbers, hyphens (`-`), and underscores (`_`)
@@ -32,8 +31,8 @@ When creating a new repository:
>
> You can't rename a Docker Hub repository once it's created.
-- The description can be up to 100 characters. It is used in the search results.
-- If you are a Docker Verified Publisher (DVP) or Docker-Sponsored Open Source (DSOS) organization, you can also add a logo to a repository. The maximum size is 1000x1000.
+- The description can be up to 100 characters. It's used in the search results.
+- If you're a Docker Verified Publisher (DVP) or Docker-Sponsored Open Source (DSOS) organization, you can also add a logo to a repository. The maximum size in pixels is 1000x1000.
- You can link a GitHub or Bitbucket account now, or choose to do it later in
the repository settings.
- You can set the repository's default visibility to public or private.
@@ -44,35 +43,16 @@ When creating a new repository:
### Add a repository overview
-Once you have created a repository, add an overview to the **Repository overview** field. This describes what your image does and how to use it.
+Once you have created a repository, add an overview to the **Repository overview** field. This describes what your image does and how to use it.
-
-
- Repository overview best practices
-
-
-
A good image description is essential to help potential users understand why and how to use the image. The below covers the best practices to follow when adding a description to your image.
-
Describe the image
-
Include a description of what the image is, the features it offers, and why people might want or need to use it in their project or image.
-
Optional information to include are examples of usage, history, the team behind the project, etc.
-
How to start and use the image
-
Provide instructions for a minimal “getting started” example with running a container using the image. Also provide a minimal example of how to use the image in a Dockerfile.
-
Optional information to include, if relevant, is:
-
- - Exposing ports
- - Default environment variables
- - Non-root user
- - Running in debug mode
-
-
Image tags and variants
-
List the key image variants and the tags for using them along with what that variant offers and why someone might want to use that variant.
-
Where to find more information
-
Add links here for docs and support sites, communities, or mailing lists where users can find more and ask questions.
-
Who is the image maintained by and how can someone contact them with concerns.
-
License
-
What is the license for the image and where can people find more details if needed.
-
-
+Consider the following repository overview best practices.
+
+- Describe what the image is, the features it offers, and why it should be used. Can include examples of usage or the team behind the project.
+- Explain how to get started with running a container using the image. You can include a minimal example of how to use the image in a Dockerfile.
+- List the key image variants and tags to use them, as well as use cases for the variants.
+- Link to documentation or support sites, communities, or mailing lists for additional resources.
+- Provide contact information for the image maintainers.
+- Include the license for the image and where to find more details if needed.
## Push a Docker container image to Docker Hub
@@ -86,11 +66,11 @@ If you want to add multiple images to a repository, add a specific `:
` to t
Name your local images using one of these methods:
-- When you build them, using `docker build -t /[:]`
-- By re-tagging an existing local image `docker tag /[:]`
-- By using `docker commit /[:]` to commit changes
+- When you build them, using `docker build -t /[:`
+- By re-tagging the existing local image with `docker tag /[:]`.
+- By using `docker commit /[:]` to commit changes.
-Now you can push this image to the repository designated by its name or tag:
+Then, you can push this image to the repository designated by its name or tag:
```console
$ docker push /:
diff --git a/docker-hub/repos/index.md b/docker-hub/repos/index.md
index 204cc37d62..4593d82f66 100644
--- a/docker-hub/repos/index.md
+++ b/docker-hub/repos/index.md
@@ -1,5 +1,5 @@
---
-description: Using repositories on Docker Hub
+description: Learn how to use repositories on Docker Hub
keywords: Docker, docker, trusted, registry, accounts, plans, Dockerfile, Docker Hub, webhooks, docs, documentation, manage, repos
title: Manage repositories
redirect_from:
diff --git a/docker-id/index.md b/docker-id/index.md
index 7016622a8b..7260a8b82d 100644
--- a/docker-id/index.md
+++ b/docker-id/index.md
@@ -1,5 +1,5 @@
---
-description: Sign up for a Docker ID and log in
+description: Learn how to register for a Docker ID and log in to your account
keywords: accounts, docker ID, billing, paid plans, support, Hub, Store, Forums, knowledge base, beta access, email, activation, verification
title: Create an account
redirect_from:
@@ -49,7 +49,7 @@ stored in your home directory in `.docker/config.json`. The password is base64-e
## Troubleshooting
-If you run into trouble with your Docker ID account, know that we are here to help! If you want to retrieve or reset your password, [enter your email address](https://id.docker.com/reset-password/){: target="_blank" rel="noopener" class="_"} for additional instructions.
+If you run into trouble with your Docker ID account, know that we're here to help! If you want to retrieve or reset your password, [enter your email address](https://id.docker.com/reset-password/){: target="_blank" rel="noopener" class="_"} for additional instructions.
You can use the [Docker forums](https://forums.docker.com/) to ask questions amongst other Docker community members, while our [hub-feedback GitHub repository](https://github.com/docker/hub-feedback) allows you to provide feedback on how we can better improve the experience with Docker Hub.
