Agent redirect skill and small admin > company reorg (#24856)

akristen · web-flow · commit 26ea39ec33ed · 2026-04-24T07:50:35.000-05:00
This PR captures a small chunk of work intended to test a new agent
skill for handling redirect aliases, link references, and link anchors.
diff --git a/.agents/skills/migrate-content-ia/SKILL.md b/.agents/skills/migrate-content-ia/SKILL.md
diff --git a/.agents/skills/migrate-content-ia/scripts/scope-pr-files.sh b/.agents/skills/migrate-content-ia/scripts/scope-pr-files.sh
@@ -0,0 +1,22 @@
+#!/bin/bash
+# List files changed on the current branch since merge-base with the target
+# branch — suitable for PR_SCOPE_FILES in PR-scoped migrate-content-ia runs.
+#
+# Usage:
+#   ./scope-pr-files.sh [target-branch]
+# Default target-branch: main
+#
+# Example (Bash / Git Bash, from repo root):
+#   bash .agents/skills/migrate-content-ia/scripts/scope-pr-files.sh
+# Example (other base):
+#   bash .../scope-pr-files.sh upstream/main
+set -euo pipefail
+
+target="${1:-main}"
+
+if ! base=$(git merge-base "$target" HEAD 2>/dev/null); then
+  echo "Error: could not merge-base with '$target'. Fetch remotes or pass a valid branch." >&2
+  exit 1
+fi
+
+git diff --name-only "$base"...HEAD
diff --git a/content/guides/admin-set-up/deploy.md b/content/guides/admin-set-up/deploy.md
@@ -30,6 +30,6 @@ for Docker.
 
 To continue optimizing your Docker environment:
 
-- Review your [organization's usage data](/manuals/admin/organization/insights.md) to track adoption
+- Review your [organization's usage data](/manuals/admin/insights.md) to track adoption
 - Monitor [Docker Scout findings](/manuals/scout/explore/analysis.md) for security insights
 - Explore [additional security features](/manuals/enterprise/security/_index.md) to enhance your configuration
diff --git a/content/guides/admin-user-management/_index.md b/content/guides/admin-user-management/_index.md
@@ -17,9 +17,9 @@ params:
     - title: Roles and permissions
       url: /security/for-admins/roles-and-permissions/
     - title: Insights
-      url: /admin/organization/insights/
+      url: /admin/insights/
     - title: Activity logs
-      url: /admin/organization/activity-logs/
+      url: /admin/activity-logs/
 ---
 
 Managing roles and permissions is key to securing your Docker environment while enabling easy collaboration and operational efficiency. This guide walks IT administrators through the essentials of user and access management, offering strategies for assigning roles, provisioning users, and using tools like activity logs and Insights to monitor and optimize Docker usage.
diff --git a/content/guides/admin-user-management/audit-and-monitor.md b/content/guides/admin-user-management/audit-and-monitor.md
@@ -24,7 +24,7 @@ Activity logs are available for Docker Team or Docker Business plans, with data
 - Team collaboration review: Logs show which team members pushed updates to a critical repository, ensuring accountability during a development sprint.
 - Billing adjustments: Track who added or removed subscription seats to maintain budgetary control and compliance.
 
-For more information, see [Activity logs](/manuals/admin/organization/activity-logs.md).
+For more information, see [Activity logs](/manuals/admin/activity-logs.md).
 
 ## Insights
 
@@ -42,13 +42,13 @@ Insights provide data-driven views of Docker usage to improve team productivity
 - Build efficiency: Track average build times and success rates to pinpoint bottlenecks in development processes.
 - Container utilization: Analyze container activity across departments to ensure proper resource distribution and cost efficiency.
 
-For more information, see [Insights](/manuals/admin/organization/insights.md).
+For more information, see [Insights](/manuals/admin/insights.md).
 
 ## Next steps
 
 Now that you've mastered user and access management in Docker, you can:
 
-- Review your [activity logs](/manuals/admin/organization/activity-logs.md) regularly to maintain security awareness
-- Check your [Insights dashboard](/manuals/admin/organization/insights.md) to identify opportunities for optimization
+- Review your [activity logs](/manuals/admin/activity-logs.md) regularly to maintain security awareness
+- Check your [Insights dashboard](/manuals/admin/insights.md) to identify opportunities for optimization
 - Explore [advanced security features](/manuals/enterprise/security/_index.md) to further enhance your Docker environment
 - Share best practices with your team to ensure consistent adoption of security policies
diff --git a/content/manuals/admin/_index.md b/content/manuals/admin/_index.md
@@ -54,13 +54,13 @@ The company owner:
 
 - Can view and manage all organizations within the company
 - Has full access to company-wide settings and inherits the same permissions as organization owners
-- Do not occupy a seat
+- Does not occupy a seat
 
 Companies are only available for Docker Business subscribers.
 
 ### Organization
 
-Organization owners have the organization owner administrator role available. They can manage organization settings, users, and access controls, but occupy a [seat](/manuals/admin/faqs/organization-faqs.md#what-is-the-difference-between-user-invitee-seat-and-member).
+Organization owners have the organization owner administrator role available. They can manage organization settings, users, and access controls, but occupy a [seat](/manuals/admin/organization/organization-faqs.md#what-is-the-difference-between-user-invitee-seat-and-member).
 
 - An organization contains teams and repositories.
 - All Docker Team and Business subscribers must have at least one organization.
diff --git a/content/manuals/admin/activity-logs.md b/content/manuals/admin/activity-logs.md
@@ -5,6 +5,7 @@ description: Learn how to access and interpret Docker activity logs for organiza
 keywords: audit log, organization activity, Docker business logs, repository activity, track changes Docker, security logs Docker, filter logs, log Docker events
 aliases:
 - /docker-hub/audit-log/
+- /admin/organization/activity-logs/
 ---
 
 {{< summary-bar feature_name="Activity logs" >}}
diff --git a/content/manuals/admin/company/_index.md b/content/manuals/admin/company/_index.md
@@ -14,15 +14,15 @@ grid:
       Learn how to add and manage organizations as well as seats within your
       company.
     icon: store
-    link: /admin/company/organizations/
+    link: /admin/company/manage/organizations/
   - title: Manage company owners
     description: Find out more about company owners and how to manage them.
     icon: supervised_user_circle
-    link: /admin/company/owners/
+    link: /admin/company/manage/owners/
   - title: Manage users
     description: Explore how to manage users in all organizations.
     icon: group_add
-    link: /admin/company/users/
+    link: /admin/company/manage/users/
   - title: Configure single sign-on
     description: Discover how to configure SSO for your entire company.
     icon: key
diff --git a/content/manuals/admin/company/company-faqs.md b/content/manuals/admin/company/company-faqs.md
@@ -1,13 +1,14 @@
 ---
-title: FAQs on companies
-linkTitle: Company
+title: Company FAQs
+linkTitle: FAQs
 weight: 30
 description: Company FAQs
 keywords: Docker, Docker Hub, SSO FAQs, single sign-on, company, administration, company management
 tags: [FAQ]
 aliases:
   - /docker-hub/company-faqs/
   - /faq/admin/company-faqs/
+  - /admin/faqs/company-faqs/
 ---
 
 ### Some of my organizations don’t have a Docker Business subscription. Can I still use a parent company?
diff --git a/content/manuals/admin/company/manage/_index.md b/content/manuals/admin/company/manage/_index.md
@@ -0,0 +1,6 @@
+---
+build:
+  render: never
+title: Manage
+weight: 20
+---
diff --git a/content/manuals/admin/company/manage/organizations.md b/content/manuals/admin/company/manage/organizations.md
@@ -1,8 +1,10 @@
 ---
 title: Manage company organizations
-linkTitle: Manage organizations
+linkTitle: Organizations
 description: Learn how to manage organizations in a company.
 keywords: company, multiple organizations, manage organizations, Docker Admin Console, organization settings, add organization, company management
+aliases:
+  - /admin/company/organizations/
 ---
 
 {{< summary-bar feature_name="Company" >}}
@@ -12,14 +14,14 @@ Learn to manage the organizations in a company using the Docker Admin Console.
 ## View all organizations
 
 1. Sign in to the [Docker Home](https://app.docker.com) and choose
-your company.
+   your company.
 1. Select **Admin Console**, then **Organizations**.
 
 The **Organizations** view displays all organizations under your company.
 
 ## Add seats to an organization
 
-If you have a [self-serve](../../subscription/details.md#self-serve)
+If you have a [self-serve](../../../subscription/details.md#self-serve)
 subscription that has no pending subscription changes, you can add seats using
 Docker Home. For more information about adding seats,
 see [Manage seats](/manuals/subscription/manage-seats.md#add-seats).
@@ -39,10 +41,10 @@ To add an organization to a company, ensure the following:
 > [!IMPORTANT]
 >
 > Once you add an organization to a company, you can't remove it from the
-company.
+> company.
 
 1. Sign in to [Docker Home](https://app.docker.com) and select your company from
-the top-left account drop-down.
+   the top-left account drop-down.
 1. Select **Admin Console**, then **Organizations**.
 1. Select **Add organization**.
 1. Choose the organization you want to add from the drop-down menu.
@@ -51,12 +53,12 @@ the top-left account drop-down.
 ## Manage an organization
 
 1. Sign in to [Docker Home](https://app.docker.com) and select your company from
-the top-left account drop-down.
+   the top-left account drop-down.
 1. Select **Admin Console**, then **Organizations**.
 1. Select the organization you want to manage.
 
 For more details about managing an organization, see
-[Organization administration](../organization/_index.md).
+[Organization administration](../../organization/_index.md).
 
 ## More resources
 
diff --git a/content/manuals/admin/company/manage/owners.md b/content/manuals/admin/company/manage/owners.md
@@ -1,9 +1,10 @@
 ---
 title: Manage company owners
-linkTitle: Manage owners
+linkTitle: Owners
 description: Learn how to add and remove company owners.
-keywords: company, owners, add company owner, remove company owner, company manageemnt, company owner permissions
+keywords: company, owners, add company owner, remove company owner, company management, company owner permissions
 aliases:
+  - /admin/company/owners/
   - /docker-hub/company-owner/
 ---
 
diff --git a/content/manuals/admin/company/manage/users.md b/content/manuals/admin/company/manage/users.md
@@ -1,8 +1,10 @@
 ---
 title: Manage company members
-linkTitle: Manage users
+linkTitle: Users
 description: Learn how to manage company members in the Docker Admin Console.
 keywords: company, company members, members, admin, Admin Console, member management, organization management, company management, bulk invite, resend invites
+aliases:
+  - /admin/company/users/
 ---
 
 {{< summary-bar feature_name="Company" >}}
@@ -142,4 +144,4 @@ see the [Bulk create invites](https://docs.docker.com/reference/api/hub/latest/#
 ## Manage members on a team
 
 Use Docker Hub to add a member to a team or remove a member from a team. For
-more details, see [Manage members](../organization/manage/members.md#manage-members-on-a-team).
+more details, see [Manage members](../../organization/manage/members.md#manage-members-on-a-team).
diff --git a/content/manuals/admin/company/new-company.md b/content/manuals/admin/company/new-company.md
@@ -1,10 +1,11 @@
 ---
-title: Create a company
+title: Create new company
 linkTitle: Create
+weight: 10
 description: Learn how to create a company to centrally manage multiple organizations.
 keywords: company, hub, organization, company owner, Admin Console, company management, Docker Business, create company, Docker Admin Console
 aliases:
-- /docker-hub/new-company/
+  - /docker-hub/new-company/
 ---
 
 {{< summary-bar feature_name="Company" >}}
@@ -24,26 +25,26 @@ Before you begin, you must:
 To create a new company:
 
 1. Sign in to [Docker Home](https://app.docker.com/) and select your
-organization.
+   organization.
 1. Select **Admin Console**, then **Company management**.
 1. Select **Create a company**.
 1. Enter a unique name for your company, then select **Continue**.
 
-    > [!TIP]
-    >
-    > The name for your company can't be the same as an existing user,
-    organization, or company namespace.
+   > [!TIP]
+   >
+   > The name for your company can't be the same as an existing user,
+   > organization, or company namespace.
 
 1. Review the migration details and then select **Create company**.
 
 For more information on how you can add organizations to your company,
-see [Add organizations to a company](./organizations.md#add-organizations-to-a-company).
+see [Add organizations to a company](./manage/organizations.md#add-organizations-to-a-company).
 
 ## Next steps
 
-- [Manage organizations](./organizations.md)
-- [Manage company members](./users.md)
-- [Manage company owners](./owners.md)
+- [Manage organizations](./manage/organizations.md)
+- [Manage company members](./manage/users.md)
+- [Manage company owners](./manage/owners.md)
 
 ## More resources
 
diff --git a/content/manuals/admin/faqs/_index.md b/content/manuals/admin/faqs/_index.md
diff --git a/content/manuals/admin/insights.md b/content/manuals/admin/insights.md
diff --git a/content/manuals/admin/organization/_index.md b/content/manuals/admin/organization/_index.md
@@ -16,7 +16,7 @@ grid:
   - title: Activity logs
     description: Learn how to audit the activities of your members.
     icon: text_snippet
-    link: /admin/organization/activity-logs/
+    link: /admin/activity-logs/
   - title: Image Access Management
     description: Control which types of images your developers can pull.
     icon: photo_library
diff --git a/content/manuals/admin/organization/manage/manage-products.md b/content/manuals/admin/organization/manage/manage-products.md
@@ -140,7 +140,7 @@ reference](/manuals/enterprise/security/hardened-desktop/settings-management/set
 
 To view usage for Docker products:
 
-- Docker Desktop: View the **Insights** page in [Docker Home](https://app.docker.com/). For more details, see [Insights](../insights.md).
+- Docker Desktop: View the **Insights** page in [Docker Home](https://app.docker.com/). For more details, see [Insights](../../insights.md).
 - Docker Hub: View the [**Usage** page](https://hub.docker.com/usage) in Docker Hub.
 - Docker Build Cloud: View the **Build minutes** page in [Docker Build Cloud](http://app.docker.com/build).
 - Docker Scout: View the [**Repository settings** page](https://scout.docker.com/settings/repos) in Docker Scout.
diff --git a/content/manuals/admin/organization/organization-faqs.md b/content/manuals/admin/organization/organization-faqs.md
@@ -1,13 +1,14 @@
 ---
+title: Organization FAQs
+linkTitle: FAQs
+weight: 60
 description: Organization FAQs
-linkTitle: Organization
-weight: 20
 keywords: Docker, Docker Hub, SSO FAQs, single sign-on, organizations, administration, Admin Console, members, organization management, manage orgs
-title: FAQs on organizations
 tags: [FAQ]
 aliases:
   - /docker-hub/organization-faqs/
   - /faq/admin/organization-faqs/
+  - /admin/faqs/organization-faqs/
 ---
 
 ### How can I see how many active users are in my organization?
diff --git a/content/manuals/docker-hub/release-notes.md b/content/manuals/docker-hub/release-notes.md
@@ -191,7 +191,7 @@ Docker introduces the Advanced Image Management dashboard that enables you to vi
 
 Docker introduces Audit logs, a new feature that allows team owners to view a list of activities that occur at organization and repository levels. This feature begins tracking the activities from the release date, that is, **from 25 January 2021**.
 
-For more information about this feature and for instructions on how to use it, see [Activity logs](../admin/organization/activity-logs.md).
+For more information about this feature and for instructions on how to use it, see [Activity logs](../admin/activity-logs.md).
 
 ## 2020-11-10
 
diff --git a/content/manuals/docker-hub/usage/pulls.md b/content/manuals/docker-hub/usage/pulls.md
@@ -55,7 +55,7 @@ Attribution is based on the following:
 - Single organization membership:
   - If the owner of the verified domain is a company and the user is part of
     only one organization within that
-    [company](../../admin/faqs/company-faqs.md#what-features-are-supported-at-the-company-level),
+    [company](../../admin/company/company-faqs.md),
     the pull is attributed to that specific organization.
   - If the user is part of only one organization, the pull is attributed to
     that specific organization.
diff --git a/content/manuals/platform-release-notes.md b/content/manuals/platform-release-notes.md
@@ -86,7 +86,7 @@ This page provides details on new features, enhancements, known issues, and bug
 
 ### New
 
-- Administrators can now view [organization Insights](/manuals/admin/organization/insights.md).
+- Administrators can now view [organization Insights](/manuals/admin/insights.md).
 
 ## 2024-07-17
 
diff --git a/content/reference/api/hub/latest.yaml b/content/reference/api/hub/latest.yaml
@@ -117,7 +117,7 @@ tags:
     description: |
       The Audit Logs API endpoints allow you to query audit log events across a namespace.
 
-      For more information, see [Audit Logs](https://docs.docker.com/admin/organization/activity-logs/).
+      For more information, see [Audit Logs](https://docs.docker.com/admin/activity-logs/).
   - name: org-settings
     x-displayName: Org Settings
     description: |
@@ -1533,7 +1533,7 @@ paths:
         - `last_seen_at`
         - `last_desktop_version`
 
-        To make visible, please see [View Insights for organization users](https://docs.docker.com/admin/organization/insights/#view-insights-for-organization-users).
+        To make visible, please see [View Insights for organization users](https://docs.docker.com/admin/insights/#view-insights-for-organization-users).
 
         <span class="oat"></span>
       tags:
@@ -3639,20 +3639,20 @@ components:
           format: date-time
           description: |
             Last time the user logged in. To access this field, you must have insights visible for your organization. See 
-            [Insights](https://docs.docker.com/admin/organization/insights/#view-insights-for-organization-users).
+            [Insights](https://docs.docker.com/admin/insights/#view-insights-for-organization-users).
           example: "2021-01-05T21:06:53.506400Z"
         last_seen_at:
           type: string
           format: date-time
           description: |
             Last time the user was seen. To access this field, you must have insights visible for your organization. See 
-            [Insights](https://docs.docker.com/admin/organization/insights/#view-insights-for-organization-users).
+            [Insights](https://docs.docker.com/admin/insights/#view-insights-for-organization-users).
           example: "2021-01-05T21:06:53.506400Z"
         last_desktop_version:
           type: string
           description: |
             Last desktop version the user used. To access this field, you must have insights visible for your organization. See 
-            [Insights](https://docs.docker.com/admin/organization/insights/#view-insights-for-organization-users).
+            [Insights](https://docs.docker.com/admin/insights/#view-insights-for-organization-users).
           example: 4.29.0
 
     org_member_paginated:
