From 639939ac5acbd65f815f98f9fabaa386a779a840 Mon Sep 17 00:00:00 2001
From: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
Date: Wed, 30 Aug 2023 08:46:06 +0100
Subject: [PATCH] icon consistency (#18030)

* icon consistency

* icon inventory

---------

Co-authored-by: Allie Sadler <alliesadler@f693mt7fh6.home>
---
 content/admin/_index.md                    |   4 +-
 content/admin/company/_index.md            |   8 +-
 content/admin/organization/_index.md       |   8 +-
 content/billing/_index.md                  |   2 +-
 content/build/_index.md                    |   2 +-
 content/compose/_index.md                  |   6 +-
 content/contribute/components/icons.md     | 151 +++++++++++++++++++++
 content/desktop/_index.md                  |   4 +-
 content/desktop/hardened-desktop/_index.md |   2 +-
 content/docker-hub/_index.md               |   6 +-
 content/docker-hub/admin-overview.md       |   8 +-
 content/engine/_index.md                   |   4 +-
 content/subscription/_index.md             |   4 +-
 data/toc.yaml                              |   2 +
 14 files changed, 182 insertions(+), 29 deletions(-)
 create mode 100644 content/contribute/components/icons.md

diff --git a/content/admin/_index.md b/content/admin/_index.md
index f2587d0473..d9700062a5 100644
--- a/content/admin/_index.md
+++ b/content/admin/_index.md
@@ -6,11 +6,11 @@ title: Docker Admin overview
 grid:
 - title: Company administration
   description: Explore how to manage a company in Docker Admin.
-  icon: lan
+  icon: apartment
   link: /admin/company/
 - title: Organization administration
   description: Learn about organization administration in Docker Admin.
-  icon: contact_page
+  icon: store
   link: /admin/organization/
 ---
 
diff --git a/content/admin/company/_index.md b/content/admin/company/_index.md
index 834ac0c8c2..bb43c5555e 100644
--- a/content/admin/company/_index.md
+++ b/content/admin/company/_index.md
@@ -6,15 +6,15 @@ grid:
 - title: Manage organizations
   description: Learn how to add and manage organizations as well as seats within your
     company.
-  icon: note_add
+  icon: store
   link: /admin/company/organizations/
 - title: Manage users
   description: Explore how to manage users in all organizations.
-  icon: contact_page
+  icon: group_add
   link: /admin/company/users/
 - title: Manage company owners
   description: Find out more about company owners and how to manage them.
-  icon: group_add
+  icon: supervised_user_circle
   link: /admin/company/owners/
 - title: Configure Single Sign-On
   description: Discover how to configure SSO for your entire company.
@@ -27,7 +27,7 @@ grid:
   link: /admin/company/settings/scim/
 - title: Domain management
   description: Add and verify your domains.
-  icon: security
+  icon: domain_verification
   link: /admin/company/settings/domains/
 ---
 
diff --git a/content/admin/organization/_index.md b/content/admin/organization/_index.md
index e9aab0b2de..9c6b3b76ef 100644
--- a/content/admin/organization/_index.md
+++ b/content/admin/organization/_index.md
@@ -5,7 +5,7 @@ title: Organization administration overview
 grid:
 - title: Manage members
   description: Explore how to manage members.
-  icon: contact_page
+  icon: group_add
   link: /admin/organization/members/
 - title: Activity logs
   description: Learn how to audit the activities of your members.
@@ -13,11 +13,11 @@ grid:
   link: /admin/organization/activity-logs/
 - title: Image Access Management
   description: Control which types of images your developers can pull.
-  icon: dynamic_feed
+  icon: photo_library
   link: /admin/organization/image-access/
 - title: Registry Access Management
   description: Define which registries your developers can access.
-  icon: all_inbox
+  icon: home_storage
   link: /admin/organization/registry-access/
 - title: General settings
   description: Configure general information or create a company.
@@ -32,7 +32,7 @@ grid:
 - title: Domain management
   description: Add, verify, and audit your domains.
   link: /admin/organization/security-settings/domains/
-  icon: security
+  icon: domain_verification
 ---
 
 {{< include "admin-early-access.md" >}}
diff --git a/content/billing/_index.md b/content/billing/_index.md
index c43c9b18d1..87265e2405 100644
--- a/content/billing/_index.md
+++ b/content/billing/_index.md
@@ -8,7 +8,7 @@ grid:
   icon: credit_score
 - title: Update the billing information
   link: /billing/details/
-  icon: contact_page
+  icon: contract_edit
 - title: View billing history
   link: /billing/history/
   icon: payments
diff --git a/content/build/_index.md b/content/build/_index.md
index 1d9e9371e1..3e7afff83d 100644
--- a/content/build/_index.md
+++ b/content/build/_index.md
@@ -15,7 +15,7 @@ grid:
 - title: Multi-platform images
   description: Build, push, pull, and run images seamlessly on different computer
     architectures.
-  icon: home_storage
+  icon: content_copy
   link: /build/building/multi-platform/
 - title: Architecture
   description: Explore BuildKit, the open source build engine.
diff --git a/content/compose/_index.md b/content/compose/_index.md
index 61ba1c6b9b..e4f840d17a 100644
--- a/content/compose/_index.md
+++ b/content/compose/_index.md
@@ -21,16 +21,16 @@ grid:
   link: /compose/release-notes
 - title: Understand key features of Compose
   description: Understand its key features and explore common use cases.
-  icon: help
+  icon: category
   link: /compose/features-uses/
 - title: Explore the Compose file reference
   description: Find information on defining services, networks, and volumes for a
     Docker application.
-  icon: all_inbox
+  icon: feature_search
   link: /compose/compose-file
 - title: Browse common FAQs
   description: Explore general FAQs and find out how to give feedback.
-  icon: sms
+  icon: help
   link: /compose/faq
 aliases:
 - /compose/cli-command/
diff --git a/content/contribute/components/icons.md b/content/contribute/components/icons.md
new file mode 100644
index 0000000000..0f3c7aad9e
--- /dev/null
+++ b/content/contribute/components/icons.md
@@ -0,0 +1,151 @@
+---
+description: Icons used across docs
+title: Icons
+grid:
+  - title: "Install"
+    icon: "download"
+    description: Icon name = download
+  - title: "FAQs"
+    icon: "help"
+    description: Icon name = help
+  - title: "Onboarding/quickstarts"
+    icon: "explore"
+    description: Icon name = explore
+  - title: "Release notes"
+    icon: "note_add"
+    description: Icon name = note_add
+  - title: "Feedback"
+    icon: "sms"
+    description: Icon name = sms
+  - title: "Multi-platform/arch"
+    icon: "content_copy"
+    description: Icon name = content_copy
+  - title: "Rootless/ECI"
+    icon: "security"
+    description: Icon name = security
+  - title: "Settings management"
+    icon: "shield_lock"
+    description: Icon name = shield_lock
+  - title: "Processes"
+    icon: "checklist"
+    description: Icon name = checklist
+  - title: "Networking"
+    icon: "network_node"
+    description: Icon name = network_node
+  - title: "Exploring a feature"
+    icon: "feature_search"
+    description: Icon name = feature_search
+  - title: "Company"
+    icon: "apartment"
+    description: Icon name = apartment
+  - title: "Organization"
+    icon: "store"
+    description: Icon name = store
+  - title: "Additional resources"
+    icon: "category"
+    description: Icon name = category
+  - title: "Designing"
+    icon: "design_services"
+    description: Icon name = design_services
+  - title: "Publishing"
+    icon: "publish"
+    description: Icon name = publish
+  - title: "Interacting"
+    icon: "multiple_stops"
+    description: Icon name = multiple_stops
+  - title: "Storage"
+    icon: "database"
+    description: Icon name = database
+  - title: "logs"
+    icon: "feed"
+    description: Icon name = feed
+  - title: "Prune/cut"
+    icon: "cut"
+    description: Icon name = cut
+  - title: "Configure"
+    icon: "tune"
+    description: Icon name = tune
+  - title: "Deprecated"
+    icon: "folder_delete"
+    description: Icon name = folder_delete
+  - title: "RAM"
+    icon: "home_storage"
+    description: Icon name = home_storage
+  - title: "IAM"
+    icon: "photo_library"
+    description: Icon name = photo_library
+  - title: "Packaging"
+    icon: "inventory_2"
+    description: Icon name = inventory_2
+  - title: "Multi-stage"
+    icon: "stairs"
+    description: Icon name = stairs
+  - title: "Architecture"
+    icon: "construction"
+    description: Icon name = construction
+  - title: "Build drivers"
+    icon: "engineering"
+    description: Icon name = engineering
+  - title: "Export"
+    icon: "output"
+    description: Icon name = output
+  - title: "Cache"
+    icon: "cycle"
+    description: Icon name = cycle
+  - title: "Bake"
+    icon: "cake"
+    description: Icon name = cake
+  - title: "Docker ID"
+    icon: "fingerprint"
+    description: Icon name = fingerprint
+  - title: "Repository"
+    icon: "inbox"
+    description: Icon name = inbox
+  - title: "Access tokens"
+    icon: "password"
+    description: Icon name = password
+  - title: "official images"
+    icon: "verified"
+    description: Icon name = verified
+  - title: "Hardened Docker Desktop"
+    icon: "lock"
+    description: Icon name = lock
+  - title: "Sign in"
+    icon: "passkey"
+    description: Icon name = passkey
+  - title: "SSO and SCIM"
+    icon: "key"
+    description: Icon name = key
+  - title: "2FA"
+    icon: "phonelink_lock"
+    description: Icon name = phonelink_lock 
+  - title: "Add/update payment method"
+    icon: "credit_score"
+    description: Icon name = credit_score 
+  - title: "Update billing info"
+    icon: "contract_edit"
+    description: Icon name = contract_edit 
+  - title: "Billing history"
+    icon: "payments"
+    description: Icon name = payments
+  - title: "Upgrade"
+    icon: "upgrade"
+    description: Icon name = upgrade
+  - title: "Add/manage more seats/users"
+    icon: "group_add"
+    description: Icon name = group_add 
+  - title: "Domains"
+    icon: "domain_verification"
+    description: Icon name = domain_verification 
+  - title: Company owner
+    description: Icon name = supervised_user_circle
+    icon: supervised_user_circle
+  - title: "General settings"
+    icon: "settings_suggest"
+    description: Icon name = settings_suggest
+---
+
+Below is an inventory of the icons we use to represent different topics or features across docs. To be used with the [cards component](cards.md).
+
+{{< grid >}}
+
diff --git a/content/desktop/_index.md b/content/desktop/_index.md
index 29682decb3..57b13bb161 100644
--- a/content/desktop/_index.md
+++ b/content/desktop/_index.md
@@ -18,7 +18,7 @@ grid:
   icon: download
 - title: Explore Docker Desktop
   description: Navigate Docker Desktop and learn about its key features.
-  icon: explore
+  icon: feature_search
   link: /desktop/use-desktop
 - title: View the release notes
   description: Find out about new features, improvements, and bug fixes.
@@ -31,7 +31,7 @@ grid:
 - title: Find additional resources
   description: Find information on networking features, deploying on Kubernetes, and
     more.
-  icon: all_inbox
+  icon: category
   link: /desktop/kubernetes
 - title: Give feedback
   description: Provide feedback on Docker Desktop or Docker Desktop features.
diff --git a/content/desktop/hardened-desktop/_index.md b/content/desktop/hardened-desktop/_index.md
index 7cdef5e12c..840c79509f 100644
--- a/content/desktop/hardened-desktop/_index.md
+++ b/content/desktop/hardened-desktop/_index.md
@@ -7,7 +7,7 @@ keywords: security, hardened desktop, enhanced container isolation, registry acc
 grid:
   - title: "Settings Management"
     description: Learn how Settings Management can secure your developers' workflows.
-    icon: "lock"
+    icon: shield_locked
     link: "/desktop/hardened-desktop/settings-management/"
   - title: "Enhanced Container Isolation"
     description: Understand how Enhanced Container Isolation can prevent container attacks.
diff --git a/content/docker-hub/_index.md b/content/docker-hub/_index.md
index 1b38bdd47a..caf3b63808 100644
--- a/content/docker-hub/_index.md
+++ b/content/docker-hub/_index.md
@@ -11,15 +11,15 @@ grid:
 - title: Create a repository
   description: Create a repository to share your images with your team, customers,
     or the Docker community.
-  icon: explore
+  icon: inbox
   link: /docker-hub/repos
 - title: Quickstart
   description: Step-by-step instructions on getting started on Docker Hub.
-  icon: checklist
+  icon: explore
   link: /docker-hub/quickstart
 - title: Manage access tokens
   description: Create personal access tokens as an alternative to your password.
-  icon: key
+  icon: password
   link: /docker-hub/access-tokens
 - title: Official images
   description: A curated set of Docker repositories hosted on Docker Hub.
diff --git a/content/docker-hub/admin-overview.md b/content/docker-hub/admin-overview.md
index 1ea1fdcfdc..cf87836da9 100644
--- a/content/docker-hub/admin-overview.md
+++ b/content/docker-hub/admin-overview.md
@@ -4,7 +4,7 @@ description: landing page for administration topic
 keywords: administration, docker hub, admin
 grid:
 - title: Create your organization
-  icon: contact_page
+  icon: add_business
   description: Explore and set up an organization in Docker Hub.
   link: /docker-hub/orgs/
 - title: Onboard your organization
@@ -18,15 +18,15 @@ grid:
 - title: Enforce sign-in
   description: Configure sign-in for members of your teams and organizations.
   link: /docker-hub/configure-sign-in/
-  icon: key
+  icon: passkey
 - title: Enable Single Sign-On
   description: Understand and use Single Sign-On.
   link: /single-sign-on/
-  icon: group_add
+  icon: key
 - title: Set up two-factor authentication
   description: Add an extra layer of authentication to your Docker account.
   link: /docker-hub/2fa/
-  icon: security
+  icon: phonelink_lock
 ---
 
 Sign in to Docker Hub to change account settings and carry out administrative or security-related tasks. 
diff --git a/content/engine/_index.md b/content/engine/_index.md
index e262ea6220..ab118f2d12 100644
--- a/content/engine/_index.md
+++ b/content/engine/_index.md
@@ -13,7 +13,7 @@ grid:
   link: /storage
 - title: Networking
   description: Manage network connections between containers.
-  icon: lan
+  icon: network_node
   link: /network
 - title: Container logs
   description: Learn how to view and read container logs.
@@ -33,7 +33,7 @@ grid:
   link: /security
 - title: Deprecated features
   description: Find out what features of Docker Engine you should stop using.
-  icon: note_add
+  icon: folder_delete
   link: /engine/deprecated/
 - title: Release notes
   description: Read the release notes for the latest version.
diff --git a/content/subscription/_index.md b/content/subscription/_index.md
index 872d6aafc2..edb8cfd87b 100644
--- a/content/subscription/_index.md
+++ b/content/subscription/_index.md
@@ -5,13 +5,13 @@ title: Docker subscription overview
 grid:
 - title: Understand Docker subscriptions and features
   link: /subscription/details/
-  icon: shop_two
+  icon: feature_search
 - title: Upgrade your subscription
   link: /subscription/upgrade/
   icon: upgrade
 - title: Add more seats to your subscription
   link: /subscription/add-seats/
-  icon: contact_page
+  icon: group_add
 - title: Explore common FAQs
   link: /subscription/faq/
   icon: help
diff --git a/data/toc.yaml b/data/toc.yaml
index 9fafdfcf54..245f98e144 100644
--- a/data/toc.yaml
+++ b/data/toc.yaml
@@ -2172,6 +2172,8 @@ Contribute:
       title: Cards
     - path: /contribute/components/code-blocks/
       title: Code blocks
+    - path: /contribute/components/icons/
+      title: Icons
     - path: /contribute/components/images/
       title: Images
     - path: /contribute/components/links/