docker · craig-osterhout · Nov 21, 2024 · Nov 12, 2024 · Nov 15, 2024
diff --git a/_vale/Docker/RecommendedWords.yml b/_vale/Docker/RecommendedWords.yml
@@ -37,7 +37,6 @@ swap:
   keypress: keystroke
   mutices: mutexes
   repo: repository
-  scan: analyze
   scroll: navigate
   url: URL
   vs: versus

diff --git a/_vale/config/vocabularies/Docker/accept.txt b/_vale/config/vocabularies/Docker/accept.txt
@@ -142,7 +142,6 @@ mfsymlinks
 minikube
 musl
 nameserver
-namespace
 npm
 osquery
 osxfs

diff --git a/content/guides/jupyter.md b/content/guides/jupyter.md
@@ -382,7 +382,7 @@
 
 ### Share your volume
 
-This example uses the Docker Desktop graphical user interface. Alternatively, in the command line interface you can [back up the volume](/engine/storage/volumes/#back-up-a-volume) and then [push it using the ORAS CLI](/manuals/docker-hub/oci-artifacts.md#push-a-volume).
+This example uses the Docker Desktop graphical user interface. Alternatively, in the command line interface you can [back up the volume](/engine/storage/volumes/#back-up-a-volume) and then [push it using the ORAS CLI](/manuals/docker-hub/repos/manage/hub-images/oci-artifacts.md#push-a-volume).
 
 1. Sign in to Docker Desktop.
 2. In the Docker Dashboard, select **Volumes**.

diff --git a/content/manuals/accounts/deactivate-user-account.md b/content/manuals/accounts/deactivate-user-account.md
@@ -32,7 +32,7 @@ Before deactivating your Docker account, ensure that you meet the following requ
 
 - Download any images and tags you want to keep. Use `docker pull -a <image>:<tag>`.
 
-- Unlink your [GitHub and Bitbucket accounts](../docker-hub/builds/link-source.md#unlink-a-github-user-account).
+- Unlink your [GitHub and Bitbucket accounts](../docker-hub/repos/manage/builds/link-source.md#unlink-a-github-user-account).
 
 ## Deactivate
 

diff --git a/content/manuals/admin/deactivate-account.md b/content/manuals/admin/deactivate-account.md
@@ -25,7 +25,7 @@ Before deactivating an organization, complete the following:
 
 - Remove all other members within the organization.
 
-- Unlink your [Github and Bitbucket accounts](../docker-hub/builds/link-source.md#unlink-a-github-user-account).
+- Unlink your [Github and Bitbucket accounts](../docker-hub/repos/manage/builds/link-source.md#unlink-a-github-user-account).
 
 ## Deactivate
 

@@ -82,7 +82,7 @@ This release contains a Kubernetes upgrade. Note that your local Kubernetes clus
 
 ### New
 
-- If you have enabled [Vulnerability Scanning](/docker-hub/vulnerability-scanning/) in Docker Hub, the scan results will now appear in Docker Desktop.
+- If you have enabled [Vulnerability Scanning](/docker-hub/repos/manage/vulnerability-scanning/) in Docker Hub, the scan results will now appear in Docker Desktop.
 
 ### Upgrades
 

@@ -74,7 +74,7 @@ This release contains a Kubernetes upgrade. Note that your local Kubernetes clus
 
 ### New
 
-- If you have enabled [Vulnerability Scanning](../../docker-hub/vulnerability-scanning.md) in Docker Hub, the scan results will now appear in Docker Desktop.
+- If you have enabled [Vulnerability Scanning](../../docker-hub/repos/manage/vulnerability-scanning.md) in Docker Hub, the scan results will now appear in Docker Desktop.
 
 ### Upgrades
 

@@ -22,7 +22,7 @@ This includes:
 - The resources in the [Learning Center](/manuals/desktop/use-desktop/_index.md)
 - Pulling or pushing an image to Docker Hub
 - [Image Access Management](/manuals/security/for-developers/access-tokens.md)
-- [Static vulnerability scanning](/manuals/docker-hub/vulnerability-scanning.md)
+- [Static vulnerability scanning](/manuals/docker-hub/repos/manage/vulnerability-scanning.md)
 - Viewing remote images in the Docker Dashboard
 - Setting up [Dev Environments](/manuals/desktop/features/dev-environments/_index.md)
 - Docker Build when using [BuildKit](/manuals/build/buildkit/_index.md#getting-started).

@@ -144,10 +144,7 @@ You can either [export a volume now](#export-a-volume-now) or [schedule a recurr
    - **Local image**: Select a local image to export the content to. Any
     existing data in the image will be replaced by the exported content.
    - **New image**: Specify a name for the new image.
-   - **Registry**: Specify a Docker Hub repository. Note that Docker Hub
-     repositories can be publicly accessible which means your data can be
-     publicly accessible. For more details, see
-     [Change a repository from public to private](/docker-hub/repos/#change-a-repository-from-public-to-private).
+   - **Registry**: Specify a Docker Hub repository.
 
    {{< /tab >}}
    {{< tab name="External cloud storage" >}}
@@ -193,10 +190,7 @@ You can either [export a volume now](#export-a-volume-now) or [schedule a recurr
    - **Local image**: Select a local image to export the content to. Any
     existing data in the image will be replaced by the exported content.
    - **New image**: Specify a name for the new image.
-   - **Registry**: Specify a Docker Hub repository. Note that Docker Hub
-     repositories can be publicly accessible which means your data can be
-     publicly accessible. For more details, see
-     [Change a repository from public to private](/docker-hub/repos/#change-a-repository-from-public-to-private).
+   - **Registry**: Specify a Docker Hub repository.
 
    {{< /tab >}}
    {{< tab name="External cloud storage" >}}

@@ -217,9 +217,6 @@ these options.
 
 ## Next steps
 
-- Automatically build container images from code through
-  [builds](builds/_index.md).
-- Use [webhooks](./webhooks.md) to cause an action in another service in
-  response to a push event in the repository.
-- Manage [repository settings](./repos/_index.md) to set the default privacy for
-  your repositories.
+Add [repository information](./repos/manage/information.md) to help users find and use
+your image.
+
@@ -31,7 +31,7 @@ Take a look at the [Docker Public Roadmap](https://github.com/orgs/docker/projec
 
 ### New
 
- - You can tag Docker Hub repositories with [categories](./repos/categories.md).
+ - You can tag Docker Hub repositories with [categories](./repos/manage/information.md#repository-categories).
 
 ## 2023-12-11
 
@@ -80,7 +80,7 @@ Take a look at the [Docker Public Roadmap](https://github.com/orgs/docker/projec
 
 ### New
 
-- The new [autobuild feature](../docker-hub/builds/manage-builds.md#check-your-active-builds) lets you view your in-progress logs every 30 seconds instead of when the build is complete.
+- The new [autobuild feature](../docker-hub/repos/manage/builds/manage-builds.md#check-your-active-builds) lets you view your in-progress logs every 30 seconds instead of when the build is complete.
 
 ## 2022-09-21
 
@@ -191,7 +191,7 @@ For more information about this feature and for instructions on how to use it, s
 
 ### New feature
 
-The **Repositories** view now shows which images have gone stale because they haven't been pulled or pushed recently. For more information, see [repository tags](repos/access/_index.md#view-repository-tags).
+The **Repositories** view now shows which images have gone stale because they haven't been pulled or pushed recently. For more information, see [repository tags](repos/manage/access/_index.md#view-repository-tags).
 
 ## 2020-10-07
 

@@ -1,88 +1,51 @@
 ---
 description: Learn how to manage repositories on Docker Hub
-keywords: Docker, docker, trusted, registry, accounts, plans, Dockerfile, Docker Hub,
-  webhooks, docs, documentation, manage, repos
-title: Manage repositories
+keywords: Docker Hub, Hub, repositories
+title: Repositories
 weight: 20
 aliases:
 - /engine/tutorials/dockerrepos/
+- /docker-hub/repos/
+- /docker-hub/repos/configure/
 ---
 
-## Manage default repository settings
-
-You can manage the default repository settings for your personal account in Docker Hub. Select the **Settings** icon, then select **Repository Settings**.
-
-![Repository settings menu](../images/docker-hub-repo-settings-menu.png)
-
-Here you can manage the following:
-
-- Default privacy: set the default repository privacy to either **Public** or **Private**.
-- Linked accounts: for users with a Docker Pro, Team, or Business subscription, manage your source provider accounts to enable Automated Builds.
-- Notifications: for users with a Docker Pro, Team, or Business subscription, manage how you receive notifications from autobuilds.
-
-## Change a repository from public to private
-
-1. Navigate to your repository.
-2. Select the **Settings** tab.
-3. Select **Make private**.
-4. Enter the name of your repository to confirm. 
-
-You get one free private repository with your Docker Hub user account (not
-available for organizations you're a member of). If you need more private
-repositories for your user account, upgrade your Docker Hub subscription from your [Billing Information](https://hub.docker.com/billing/plan) page.
-
-## Move images between repositories
-
-### Personal to personal
-
-When consolidating personal repositories, you can pull private images from the initial repository and push them into another repository owned by you. To avoid losing your private images, perform the following steps:
-
-1. Navigate to [Docker Hub](https://hub.docker.com) create a new Docker ID and select a personal subscription.
-2. Using `docker login` from the CLI, sign in using your original Docker ID and pull your private images.
-3. Tag your private images with your newly created Docker ID, for example:
-
-   ```console
-   $ docker tag namespace1/docker101tutorial new_namespace/docker101tutorial
-   ```
-4. Using `docker login` from the CLI, sign in with your newly created Docker ID, and push your newly tagged private images to your new Docker ID namespace:
-
-   ```console
-   $ docker push new_namespace/docker101tutorial
-   ```
-
-The private images that existed in your previous account are now available in your new account.
-
-### Personal to an organization
-
-To avoid losing your private images, you can pull your private images from your personal account and push them to an organization that's owned by you.
-
-1. Navigate to [Docker Hub](https://hub.docker.com) and select **Organizations**.
-2. Select the applicable organization and verify that your user account is a member of the organization.
-3. Sign in to [Docker Hub](https://hub.docker.com) using your original Docker ID, and pull your images:
-
-   ```console
-   $ docker pull namespace1/docker101tutorial
-   ```
-4. Tag your images with your new organization namespace:
-
-   ```console
-   $ docker tag namespace1/docker101tutorial <new_org>/docker101tutorial
-   ```
-5. Push your newly tagged images to your new org namespace:
-
-   ```console
-   $ docker push new_org/docker101tutorial
-   ```
-
-The private images that existed in your user account are now available for your organization.
-
-## Delete a repository
-
-> [!WARNING]
->
-> Deleting a repository deletes all the images it contains and its build settings. This action can't be undone.
-
-1. Navigate to your repository.
-2. Select the **Settings** tab.
-3. Select **Delete repository**.
-4. Enter the name of your repository to confirm.
+A Docker Hub repository is a collection of container images, enabling you to
+store, manage, and share Docker images publicly or privately. Each repository
+serves as a dedicated space where you can store images associated with a
+particular application, microservice, or project. Content in repositories is
+organized by tags, which represent different versions of the same application,
+allowing users to pull the right version when needed.
+
+## Key features and concepts
+
+- [Repository information](./manage/information.md): Each repository can include a
+  description, an overview, and categories to help users understand its purpose
+  and usage. Adding clear repository information ensures that others can find
+  your images and know how to use them.
+
+- [Access management](./manage/access.md): Docker Hub repositories offer flexible
+  access options. You can make repositories public or private and add
+  collaborators. For organizations, teams, roles, and access tokens enable
+  fine-grained access, providing security and control at scale.
+
+- [Image management](./manage/hub-images/_index.md): Repositories support
+  various types of content, including OCI artifacts, and provide robust version
+  control with tagging. You can push new images and move existing content
+  between repositories, ensuring flexibility in managing different versions and
+  types of container images.
+
+- [Webhooks](./manage/webhooks.md): Webhooks let you automate responses to repository
+  events. For instance, you can set up notifications or trigger actions in
+  external systems whenever an image is pushed or updated, helping to streamline
+  workflows.
+
+- [Automated builds](./manage/builds/_index.md): Docker Hub
+  repositories integrate with GitHub or Bitbucket for automated builds, ensuring
+  that every code change triggers an image rebuild. This feature supports
+  continuous integration and delivery, keeping images up-to-date and
+  streamlining development pipelines.
+
+- [Image security insights](./manage/vulnerability-scanning.md): Docker Hub repositories
+  provide powerful features and controls to help uncover, understand, and fix
+  issues with container images. Options for image security insights include
+  continuous Docker Scout image analysis and static vulnerability scanning.
-Original file line number
+Diff line change
@@ Expand Up / @@ -142,7 +142,6 @@ mfsymlinks @@
     minikube
     musl
     nameserver
-    namespace
     npm
     osquery
     osxfs
@@ Expand Down @@