subscription overview updates POC#25067
Conversation
Replace the brief subscription intro with summaries for personal, organization, and sales-led enterprise plans, feature comparison tables, and a redirect alias for /subscription/overview/. The Personal Hub pull rate matches docker-hub/usage/pulls.md (200 pulls per 6 hours for authenticated users). Co-authored-by: Cursor <cursoragent@cursor.com>
Correct subject-verb agreement, use standard self-serve add-ons wording, prefer active voice for org admins, and trim trailing whitespace. Co-authored-by: Cursor <cursoragent@cursor.com>
✅ Deploy Preview for docsdocker ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
docker-agent
left a comment
There was a problem hiding this comment.
Assessment: 🟡 NEEDS ATTENTION
This POC rewrites the subscription overview from a brief navigation page into a detailed reference page with feature-comparison tables. The content is well-structured and the information is accurate. Six style guide violations were found — all medium severity — primarily meta-commentary patterns, vague marketing language, passive voice, and scope inflation concerns. The grid reduction (7→3 items) also removes discoverable links to several subscription management pages.
| --- | ||
|
|
||
| Docker subscriptions provide licensing for commercial use of Docker products including Docker Desktop, Docker Hub, Docker Build Cloud, Docker Scout, and Testcontainers Cloud. | ||
| This page summarizes Docker subscription plans and optional add-ons for personal accounts, organization accounts, and sales-led enterprise programs. |
There was a problem hiding this comment.
[MEDIUM] Opening paragraph uses meta-commentary ('This page summarizes...')
The sentence opens with "This page summarizes..." which is a meta-commentary pattern explicitly called out in the style guide. Instead of announcing what the page does, the opening paragraph should directly state what the reader will learn and why it matters — for example: "Docker subscriptions come in four tiers — Personal, Pro, Team, and Business — each designed for different scales of use."
| - Docker Team is an organization subscription that improves collaboration across small developer teams. | ||
| - Docker Business adds security and governance capabilities for larger regulated environments. | ||
|
|
||
| Whether you're developing with personal or organization accounts, Docker offers a suite of products that enhances your development workflows. |
There was a problem hiding this comment.
[MEDIUM] Vague marketing-style sentence: 'Docker offers a suite of products that enhances your development workflows'
This sentence is vague filler — it doesn't tell users which products or how workflows are enhanced. Per the style guide, avoid marketing language and instead describe what something actually does. Consider removing this sentence entirely, since the sections that follow already enumerate the specific products.
|
|
||
| ### Docker Personal and Docker Pro | ||
|
|
||
| The table provides an abridged comparison of Docker Personal and Docker Pro accounts. |
There was a problem hiding this comment.
[MEDIUM] Meta-commentary sentence before table ('The table provides an abridged comparison')
"The table provides an abridged comparison of Docker Personal and Docker Pro accounts" is a meta-commentary sentence describing the table rather than presenting information. Per the style guide, avoid announcing what follows — just present the content. Remove this sentence and let the table stand on its own (the section heading already provides the context).
| - For organization accounts, you can purchase hardened repos with DHI Select. | ||
| - For personal accounts, you can add Gordon Plus, Max, or Ultra as a subscription layer that multiplies your Gordon usage. | ||
|
|
||
| Products available for add-ons can be found by signing into [Docker Home](https://app.docker.com/) from your personal or organization account, then selecting **Billing > Browse Products**. |
There was a problem hiding this comment.
[MEDIUM] Passive/wordy phrasing: 'Products available for add-ons can be found by'
"Products available for add-ons can be found by signing into..." is a passive construction. The style guide calls for direct, active writing. Rewrite as: "To find products available as add-ons, sign into Docker Home from your personal or organization account, then select Billing > Browse Products."
| --- | ||
|
|
||
| Docker subscriptions provide licensing for commercial use of Docker products including Docker Desktop, Docker Hub, Docker Build Cloud, Docker Scout, and Testcontainers Cloud. | ||
| This page summarizes Docker subscription plans and optional add-ons for personal accounts, organization accounts, and sales-led enterprise programs. |
There was a problem hiding this comment.
[MEDIUM] Significant scope inflation — file grew from ~47 to ~112 lines
The original file was ~47 lines (a brief overview pointing to child pages). The new version is ~112 lines with detailed feature-comparison tables, multiple sub-sections, and prose. The style guide explicitly cautions: "If the document is brief and direct (90 lines), keep it that way. Don't transform a focused guide into an exhaustive tutorial."
Since this is a POC, this may be intentional — but it's worth confirming the new scope is desired before merging, as the page now duplicates information already available on the pricing page and in linked sub-pages.
| description: Find the answers you need and explore common questions. | ||
| link: /subscription/faq/ | ||
| icon: help | ||
| - title: Create an account |
There was a problem hiding this comment.
[MEDIUM] Navigation grid reduced from 7 to 3 items — subscription management pages no longer discoverable from landing page
The original grid surfaced 7 pages: Compare subscriptions, Set up, Scale, Change subscription, Manage seats, Docker Desktop license agreement, and Subscription FAQs. The new grid has only 3 items, removing direct links to /subscription/change/, /subscription/manage-seats/, /subscription/desktop-license/, and /subscription/faq/.
These pages still exist but are no longer reachable from the main subscription landing page, which is typically the first stop for users managing their subscription. If this restructuring is intentional (e.g., these pages will be moved elsewhere or the nav is being rebuilt), that's fine — but worth a callout to confirm.
Experimenting with overhauling Subscription doc to align with future docker subscription/billing updates