diff --git a/content/docker-hub/repos/categories.md b/content/docker-hub/repos/categories.md new file mode 100644 index 0000000000..99b90e2bdf --- /dev/null +++ b/content/docker-hub/repos/categories.md @@ -0,0 +1,79 @@ +--- +title: Categories in Docker Hub +description: | + Categorizing your Docker Hub repositories makes it easier for users to + find your images based on its use cases and content. +keywords: hub, images, content, categories, explore, search +--- + +> **Early Access** +> +> Categories is an [Early Access](/release-lifecycle/#early-access-ea) +> feature of Docker Hub. It's currently only available to members of the +> [Docker Verified Publisher](../../trusted-content/dvp-program.md) +> and [Docker-Sponsored Open Source](../../trusted-content/dsos-program.md) +> programs. +{ .restricted } + +You can tag Docker Hub repositories with categories, representing the primary +intended use cases for your images. This lets users more easily find and +explore content for the problem domain that they're interested in. + +## Available categories + +The Docker Hub content team maintains a curated list of categories. +The available categories are: + +- **API Management**: Tools for creating, publishing, analyzing, and securing APIs. +- **Content Management System:** Software applications to create and manage digital content through templates, procedures, and standard formats. +- **Data Science:** Tools and software to support analyzing data and generating actionable insights. +- **Databases & Storage:** Systems for storing, retrieving, and managing data. +- **Languages & Frameworks:** Programming language runtimes and frameworks. +- **Integrations & Delivery:** Tools for Continuous Integration (CI) and Continuous Delivery (CD). +- **Internet of Things:** Tools supporting Internet of Things (IoT) applications. +- **Machine Learning & AI:** Tools and frameworks optimized for artificial intelligence and machine learning projects, such as pre-installed libraries and frameworks for data analysis, model training, and deployment. +- **Message Queues:** Message queuing systems optimized for reliable, scalable, and efficient message handling. +- **Monitoring & Observability:** Tools to track software and system performance through metrics, logs, and traces, as well as observability to explore the system’s state and diagnose issues. +- **Networking:** Repositories that support data exchange and connecting computers and other devices to share resources. +- **Operating Systems:** Software that manages all other programs on a computer and serves as an intermediary between users and the computer hardware, while overseeing applications and system resources. +- **Security:** Tools to protect a computer system or network from theft, unauthorized access, or damage to their hardware, software, or electronic data, as well as from service disruption. +- **Web Servers:** Software to serve web pages, HTML files, and other assets to users or other systems. +- **Web Analytics:** Tools to collect, measure, analyze, and report on web data and website visitor engagement. + +## Auto-generated categories + +> **Note** +> +> Auto-generated categories only apply to Docker Official Images, Docker +> Verified Publishers, and Docker-Sponsored Open Source program participants. + +For repositories that pre-date the Categories feature in Docker Hub, +categories have been automatically generated and applied, using OpenAI, based +on the repository title and description. + +As an owner of a repository that has been auto-categorized, you can manually +edit the categories if you think they're inaccurate. See [Manage categories for +a repository](#manage-categories-for-a-repository). + +The auto-generated categorization was a one-time effort to help seed categories +onto repositories created before the feature existed. Categories are not +assigned to new repositories automatically. + +## Manage categories for a repository + +You can tag a repository with up to three categories. + +To edit the categories of a repository: + +1. Go to the repository page on Docker Hub. +2. Select the pencil icon under the description field. +3. Select the categories you want to apply. +4. Select **Update** to save the changes. + + + +If you're missing a category, use the +[Give feedback link](https://docker.qualtrics.com/jfe/form/SV_03CrMyAkCWVylKu) +to let us know what categories you'd like to see. diff --git a/data/toc.yaml b/data/toc.yaml index 69fa441261..79607892bc 100644 --- a/data/toc.yaml +++ b/data/toc.yaml @@ -2055,6 +2055,8 @@ Manuals: title: Access - path: /docker-hub/repos/ title: Manage + - path: /docker-hub/repos/categories/ + title: Categories - path: /docker-hub/download-rate-limit/ title: Download rate limit - path: /docker-hub/webhooks/ diff --git a/static/assets/video/hub_categories.mp4 b/static/assets/video/hub_categories.mp4 new file mode 100644 index 0000000000..c60c6a8a84 Binary files /dev/null and b/static/assets/video/hub_categories.mp4 differ