Repos UI updates (#9825)

* updates to repos page based on cloud and Hub UI consolidation

Signed-off-by: Lena Larionova <lena.larionova@docker.com>

* spacing

Signed-off-by: Lena Larionova <lena.larionova@docker.com>

docker-hub/release-notes.md

@@ -9,6 +9,18 @@ toc_max: 2
 Here you can learn about the latest changes, new features, bug fixes, and
 known issues for each Docker Hub release.
 
+# 2019-11-04
+
+### Enhancements
+
+* The [repositories page](https://docs.docker.com/docker-hub/repos/) and all
+related settings and tabs have been updated and moved from `cloud.docker.com`
+to `hub.docker.com`. You can access the page at its new URL: [https://hub.docker.com/repositories](https://hub.docker.com/repositories). 
+
+### Known Issues
+
+* Scan results don't appear for some official images.
+
 # 2019-10-21
 
 ### New features
@@ -18,8 +30,6 @@ known issues for each Docker Hub release.
     > not be able to recover your account.
     {: .important }
 
-
-
 ### Enhancements
 * As a security measure, when two-factor authentication is enabled, the Docker CLI requires a personal access token instead of a password to log in.
 

docker-hub/repos.md

@@ -7,42 +7,57 @@ title: Repositories
 Docker Hub repositories allow you share container images with your team,
 customers, or the Docker community at large.
 
-Docker images are pushed to Docker Hub through the [`docker push`](https://docs.docker.com/engine/reference/commandline/push/) command. A single Docker Hub repository can hold many Docker images (stored as **tags**).
+Docker images are pushed to Docker Hub through the [`docker push`](https://docs.docker.com/engine/reference/commandline/push/)
+command. A single Docker Hub repository can hold many Docker images (stored as
+**tags**).
 
-## Creating Repositories
+## Creating repositories
 
-To create a repository, sign into Docker Hub, click on **Repositories** then **Create Repo**:
+To create a repository, sign into Docker Hub, click on **Repositories** then
+**Create Repository**:
 
 ![Create repo](images/repos-create.png)
 
-When creating a new repository, you can choose to put it in your Docker ID
-namespace, or that of any [Organization](/docker-hub/orgs.md) that you are in the "Owners"
-team. The Repository Name needs to be unique in that namespace, can be two
+When creating a new repository:
+
+ * You can choose to put it in your Docker ID
+namespace, or in any [organization](/docker-hub/orgs.md) where you are an
+[_owner_](/orgs/#the-owners-team).
+
+* The repository name needs to be unique in that namespace, can be two
 to 255 characters, and can only contain lowercase letters, numbers or `-` and
 `_`.
 
-The "Short Description" of 100 characters is used in the search results,
-while the "Full Description" can be used as the Readme for the repository, and
-can use Markdown to add simple formatting.
+* The description can be up to 100 characters and is used in the search
+result.
 
-After you hit the "Create" button, you then need to `docker push` images to that
-Hub based repository.
+* You can link a GitHub or Bitbucket account now, or choose to do it
+later in the repository settings.
+
+![Setting page for creating a repo](images/repo-create-details.png)
+
+
+After you hit the **Create** button, you can start using `docker push` to push
+images to this repository.
 
 ## Pushing a Docker container image to Docker Hub
 
-To push a repository to the Docker Hub, you must
-name your local image using your Docker Hub username, and the
-repository name that you created through Docker Hub on the web.
+To push an image to Docker Hub, you must first name your local image using your
+Docker Hub username and the repository name that you created through Docker Hub
+on the web.
 
-You can add multiple images to a repository, by adding a specific `:<tag>` to
-it (for example `docs/base:testing`). If it's not specified, the tag defaults to
-`latest`.
+You can add multiple images to a repository by adding a specific `:<tag>` to
+them (for example `docs/base:testing`). If it's not specified, the tag defaults
+to `latest`.
 
-You can name your local images either when you build it, using
-`docker build -t <hub-user>/<repo-name>[:<tag>]`,
-by re-tagging an existing local image `docker tag <existing-image> <hub-user>/<repo-name>[:<tag>]`,
-or by using `docker commit <existing-container> <hub-user>/<repo-name>[:<tag>]` to commit
-changes.
+Name your local images using one of these methods:
+* When you build them, using
+`docker build -t <hub-user>/<repo-name>[:<tag>]`
+
+* By re-tagging an existing local image `docker tag <existing-image> <hub-user>/<repo-name>[:<tag>]`
+
+* By using `docker commit <existing-container> <hub-user>/<repo-name>[:<tag>]`
+to commit changes
 
 Now you can push this repository to the registry designated by its name or tag.
 
@@ -51,22 +66,23 @@ Now you can push this repository to the registry designated by its name or tag.
 The image is then uploaded and available for use by your teammates and/or
 the community.
 
-## Private Repositories
+## Private repositories
 
-Private repositories allow you keep container images private, either to your own account or within an organization or
-team.
+Private repositories let you keep container images private, either to your
+own account or within an organization or team.
 
-To create a private repo select **Private** when creating a private repo:
+To create a private repository, select **Private** when creating a repository:
 
 ![Create Private Repo](images/repo-create-private.png)
 
-You can also make an existing repository private by going to the repo's **Settings** tab:
+You can also make an existing repository private by going to its **Settings** tab:
 
 ![Convert Repo to Private](images/repo-make-private.png)
 
-You get one private repository for free with your Docker Hub user account (not usable for
-organizations you're a member of). If you need more private repositories for your user account, upgrade
-your Docker Hub plan from your [Billing Information](https://hub.docker.com/billing/plan) page.
+You get one private repository for free with your Docker Hub user account (not
+usable for organizations you're a member of). If you need more private
+repositories for your user account, upgrade your Docker Hub plan from your
+[Billing Information](https://hub.docker.com/billing/plan) page.
 
 Once the private repository is created, you can `push` and `pull` images to and
 from it using Docker.
@@ -74,11 +90,11 @@ from it using Docker.
 > **Note**: You need to be signed in and have access to work with a
 > private repository.
 
-> **Note**: Private repositories are not currently available to search through the
-top-level search or `docker search`
+> **Note**: Private repositories are not currently available to search through
+> the top-level search or `docker search`.
 
 You can designate collaborators and manage their access to a private
-repository from that repository's *Settings* page. You can also toggle the
+repository from that repository's **Settings** page. You can also toggle the
 repository's status between public and private, if you have an available
 repository slot open. Otherwise, you can upgrade your
 [Docker Hub](https://hub.docker.com/account/billing-plans/) plan.
@@ -102,53 +118,59 @@ see the [organizations documentation](/docker-hub/orgs.md).
 ## Viewing repository tags
 
 Docker Hub's individual repositories view shows you the available tags and the
-size of the associated image. Go to the "Repositories" view and click on a
+size of the associated image. Go to the **Repositories** view and click on a
 repository to see its tags.
 
-![Repository View](images/repo-view-2019.png)
+![Repository View](images/repos-create.png)
 
-![View Repo Tags](images/repos-tags-view-2019.png)
+![View Repo Tags](images/repo-overview.png)
 
 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
+images. This is also the disk space used by the contents of the `.tar` file
 created when you `docker save` an image.
 
-To view tags, click on "Tags" tab and then select a tag to view.
+To view individual tags, click on the **Tags** tab.
 
-![Manage Repo Tags](images/repos-tags-manage-2019.png)
+![Manage Repo Tags](images/repo-tags-list.png)
 
-![View Tag](images/repo-single-tag-view-2019.png)
+Select a tag's digest to view details.
+
+![View Tag](images/repo-image-layers.png)
 
 ## Searching for Repositories
 
-You can search the [Docker Hub](https://hub.docker.com) registry through its search
-interface or by using the command line interface. Searching can find images by
-image name, user name, or description:
+You can search the [Docker Hub](https://hub.docker.com) registry through its
+search interface or by using the command line interface. Searching can find
+images by image name, username, or description:
 
-    $ docker search centos
-    NAME                                 DESCRIPTION                                     STARS     OFFICIAL   AUTOMATED
-    centos                               The official build of CentOS.                   1034      [OK]
-    ansible/centos7-ansible              Ansible on Centos7                              43                   [OK]
-    tutum/centos                         Centos image with SSH access. For the root...   13                   [OK]
-    ...
+```
+$ docker search centos
+NAME                                 DESCRIPTION                                     STARS     OFFICIAL   AUTOMATED
+centos                               The official build of CentOS.                   1034      [OK]
+ansible/centos7-ansible              Ansible on Centos7                              43                   [OK]
+tutum/centos                         Centos image with SSH access. For the root...   13                   [OK]
+...
+```
 
 There 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
-repository which means that it comes from the top-level namespace for [Official
-Images](/docker-hub/official_images.md). The `/` character separates a user's
+repository which means that it comes from the top-level namespace for [official
+images](/docker-hub/official_images.md). The `/` character separates a user's
 repository from the image name.
 
 Once you've found the image you want, you can download it with `docker pull <imagename>`:
 
-    $ docker pull centos
-    latest: Pulling from centos
-    6941bfcbbfca: Pull complete
-    41459f052977: Pull complete
-    fd44297e2ddb: Already exists
-    centos:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security.
-    Digest: sha256:d601d3b928eb2954653c59e65862aabb31edefa868bd5148a41fa45004c12288
-    Status: Downloaded newer image for centos:latest
+```
+$ docker pull centos
+latest: Pulling from centos
+6941bfcbbfca: Pull complete
+41459f052977: Pull complete
+fd44297e2ddb: Already exists
+centos:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security.
+Digest: sha256:d601d3b928eb2954653c59e65862aabb31edefa868bd5148a41fa45004c12288
+Status: Downloaded newer image for centos:latest
+```
 
 You now have an image from which you can run containers.