gordon: GA release documentation updates

- Remove Beta badge and availability marker; Gordon is now GA
- Update subscriber note: available to all Docker accounts, Business
  admins control access via Admin Console (no longer requires Support contact)
- Replace "Beta features" settings path with "AI" section across all pages
- Add usage-limits.md covering Base/Plus/Max/Ultra plans, approximate
  question limits per time window, usage indicator, and docs.docker.com Gordon
- Document contextual help entrypoints from Containers, Images, and Builds views
- Document usage indicator in Docker Desktop

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: dvdksn

content/manuals/ai/gordon/_index.md

@@ -6,9 +6,6 @@ description:
 weight: 40
 params:
   sidebar:
-    badge:
-      color: blue
-      text: Beta
     group: AI and agents
 aliases:
   - /desktop/features/gordon/
@@ -38,12 +35,13 @@ Gordon proposes every action before executing. You approve what it does.
 
 Before you begin:
 
-- Docker Desktop 4.61.0 or later
+- Docker Desktop 4.74 or later
 - Sign in to your Docker account
 
 > [!NOTE]
-> Gordon is enabled by default for Personal, Pro, and Team subscriptions.
-> Business subscribers must complete two steps before users can access Gordon:
+> Gordon is enabled by default for signed-in Docker users. If your account
+> belongs to an organization with a Business subscription, access requires two
+> additional steps:
 >
 > 1. Contact Docker Support to activate Gordon for your organization. Docker
 >    will confirm when activation is complete.

content/manuals/ai/gordon/concepts/data-privacy.md

@@ -51,8 +51,8 @@ processed are not stored.
 
 ### Personal (free) subscription
 
-Conversation threads are stored for 30 days to improve the service. Individual
-queries and responses are retained as part of your conversation history.
+Anonymized conversation threads are stored for 30 days to improve the service.
+Individual queries and responses are retained as part of your conversation history.
 
 ### All subscriptions
 
@@ -85,7 +85,7 @@ You can disable Gordon at any time:
 Individual users:
 
 1. Open Docker Desktop Settings.
-2. Navigate to the **Beta features** section.
+2. Navigate to the **AI** section.
 3. Clear the **Enable Gordon** option.
 4. Select **Apply**.
 

content/manuals/ai/gordon/how-to/cli.md

@@ -54,7 +54,7 @@ Gordon CLI is part of Docker Desktop. To disable it, disable Gordon in Docker
 Desktop Settings:
 
 1. Open Docker Desktop Settings.
-2. Navigate to the **Beta features** section.
+2. Navigate to the **AI** section.
 3. Clear the **Enable Gordon** option.
 4. Select **Apply**.
 

content/manuals/ai/gordon/how-to/docker-desktop.md

@@ -30,12 +30,23 @@ to change it during a conversation:
 1. Select the directory icon in the Gordon input area.
 2. Browse and select a different directory.
 
+## Contextual help
+
+The Gordon icon appears throughout Docker Desktop. Selecting it opens Gordon
+pre-loaded with context about the item you are working with, such as container
+logs or build output.
+
+## Usage indicator
+
+Docker Desktop shows a usage indicator so you can see how close you are to
+your tier limit. See [Usage limits and tiers](../usage-limits.md) for details.
+
 ## Disabling Gordon
 
 To disable Gordon:
 
 1. Open Docker Desktop Settings.
-2. Navigate to the **Beta features** section.
+2. Navigate to the **AI** section.
 3. Clear the **Enable Gordon** option.
 4. Select **Apply**.
 

content/manuals/ai/gordon/usage-limits.md

@@ -0,0 +1,51 @@
+---
+title: Gordon usage limits and tiers
+linkTitle: Usage limits
+description: Gordon subscription tiers and usage limits for Docker Desktop and the CLI
+weight: 50
+keywords: [gordon, usage, limits, tiers, base, plus, max, ultra, subscription]
+---
+
+{{< summary-bar feature_name="Gordon" >}}
+
+Gordon is included with every Docker account at the Base tier. Paid Gordon
+plans unlock higher usage limits.
+
+## Tiers
+
+| Tier  | Usage allocation                 |
+| ----- | -------------------------------- |
+| Base  | Included with any Docker account |
+| Plus  | 2× Base                          |
+| Max   | 5× Base                          |
+| Ultra | 20× Base                         |
+
+To upgrade your Gordon tier, visit your account settings on
+[docker.com](https://www.docker.com).
+
+## Usage limits
+
+Gordon usage is measured in questions. The number you can ask depends on
+complexity: questions that involve more context, files, or Docker operations
+count more toward your limit.
+
+| Tier  | Per 4 hours | Per day | Per month |
+| ----- | ----------- | ------- | --------- |
+| Base  | ~40         | ~100    | ~180      |
+| Plus  | ~80         | ~200    | ~360      |
+| Max   | ~200        | ~500    | ~900      |
+| Ultra | ~800        | ~2,000  | ~3,600    |
+
+These are estimates and vary based on question complexity.
+
+## View your usage
+
+Docker Desktop shows a usage indicator so you can see how close you are to
+your limit. To get more usage, upgrade your tier.
+
+## Gordon on docs.docker.com
+
+Gordon is also available on [docs.docker.com](https://docs.docker.com) to
+answer documentation questions. It's free for all users with its own separate
+usage limit. It only answers questions about Docker documentation and does not
+include tool use or access to your Docker environment.

content/manuals/ai/gordon/use-cases.md

@@ -7,112 +7,130 @@ weight: 10
 
 {{< summary-bar feature_name="Gordon" >}}
 
-Gordon handles Docker workflows through natural conversation. This page shows
-example prompts for the most common use cases.
+Gordon handles Docker workflows through natural conversation. Start a session
+in the Gordon sidebar in Docker Desktop or run `docker ai` in your terminal,
+then describe what you need.
 
 ## Debug and troubleshoot
 
 Fix broken containers, diagnose build failures, and resolve issues.
 
-```console
-# Diagnose container crashes
-$ docker ai "why did my postgres container crash?"
+In the Gordon sidebar:
 
-# Debug build failures
-$ docker ai "my build is failing at the pip install step, what's wrong?"
+- "Why is my container exiting immediately?"
+- "Fix this Docker build error"
+- "My app can't connect to the database"
+- "My container is using too much memory, help me investigate"
 
-# Fix networking issues
-$ docker ai "my web container can't reach my database container"
+Via CLI:
 
-# Investigate performance problems
-$ docker ai "my container is using too much memory, help me investigate"
+```console
+$ docker ai "why is my container exiting immediately?"
+$ docker ai "my build is failing at the pip install step, what's wrong?"
+$ docker ai "my web container can't reach my database container"
 ```
 
 ## Build and containerize
 
 Create Docker assets for applications and migrate to hardened images.
 
+In the Gordon sidebar:
+
+- "Containerize my Node.js app"
+- "Create a docker-compose for my stack"
+- "Set up a dev environment with Postgres and Redis"
+
+Via CLI:
+
 ```console
-# Create Dockerfile from scratch
 $ docker ai "create a Dockerfile for my Node.js application"
-
-# Generate compose file
 $ docker ai "create a docker-compose.yml for my application stack"
-
-# Migrate to Docker Hardened Images
 $ docker ai "migrate my Dockerfile to use Docker Hardened Images"
 ```
 
 ## Execute operations
 
 Run Docker commands to manage containers, images, and resources.
 
+In the Gordon sidebar:
+
+- "Stop all running containers"
+- "Clean up unused images"
+- "Pull and run nginx"
+
+Via CLI:
+
 ```console
-# Start containers with configuration
 $ docker ai "run a redis container with persistence"
-
-# Build and tag images
 $ docker ai "build my Dockerfile and tag it for production"
-
-# Clean up resources
 $ docker ai "clean up all unused Docker resources"
 ```
 
 ## Develop and optimize
 
 Improve Dockerfiles and configure secure, efficient development environments.
 
+In the Gordon sidebar:
+
+- "Optimize this Dockerfile"
+- "Add a health check to my service"
+- "Make my Dockerfile more secure"
+
+Via CLI:
+
 ```console
-# Optimize existing Dockerfile
 $ docker ai "rate my Dockerfile and suggest improvements"
-
-# Add security improvements
 $ docker ai "make my Dockerfile more secure"
-
-# Configure development workflow
 $ docker ai "set up my container for development with hot reload"
 ```
 
 ## Manage resources
 
 Inspect containers, images, and resource usage.
 
+In the Gordon sidebar:
+
+- "Show me running containers"
+- "How much disk space is Docker using?"
+- "List my images"
+
+Via CLI:
+
 ```console
-# Check container status
 $ docker ai "show me all my containers and their status"
-
-# Analyze disk usage
 $ docker ai "how much disk space is Docker using?"
-
-# Review image details
 $ docker ai "list my images sorted by size"
 ```
 
 ## Learn Docker
 
 Understand concepts and commands in the context of your projects.
 
-```console
-# Explain Docker concepts
-$ docker ai "explain how Docker networking works"
+In the Gordon sidebar:
+
+- "What is a Docker volume?"
+- "Explain multi-stage builds"
+- "How does networking work in Docker?"
 
-# Understand commands
-$ docker ai "what's the difference between COPY and ADD in Dockerfile?"
+Via CLI:
 
-# Get troubleshooting guidance
+```console
+$ docker ai "explain how Docker networking works"
+$ docker ai "what's the difference between COPY and ADD in a Dockerfile?"
 $ docker ai "how do I debug a container that exits immediately?"
 ```
 
-
 ## Writing effective prompts
 
 Be specific:
+
 - Include relevant context: "my postgres container" not "the database"
 - State your goal: "make my build faster" not "optimize"
 - Include error messages when debugging
 
 Gordon works best when you describe what you want to achieve rather than how to
-do it.
+do it. Gordon maintains context across a conversation, so you can follow up with
+clarifications or ask related questions without repeating yourself.
 
 ### Working directory context
 

data/summary.yaml

@@ -15,7 +15,6 @@ Allow list:
 Amazon S3 cache:
   availability: Experimental
 Gordon:
-  availability: Beta
   requires: Docker Desktop [4.61.0](/manuals/desktop/release-notes.md#4610) or later
 Gordon DHI migration:
   availability: Experimental