Skip to content

licenses#25181

Open
akristen wants to merge 7 commits into
docker:mainfrom
akristen:ai-gov-license
Open

licenses#25181
akristen wants to merge 7 commits into
docker:mainfrom
akristen:ai-gov-license

Conversation

@akristen
Copy link
Copy Markdown
Contributor

@akristen akristen commented May 27, 2026

Early draft staging for docs that overview licenses and license management for new product + managing Enterprise Offload. Docs are in early draft state and not ready for review.

To Dos:

  • Updates to Docker Products docs (nice-to-have)
  • Identify areas to add links to AI Governance (look at pr)
  • Get review

Document organization licenses for Docker Offload and AI Governance,
including manual and automatic assignment from the Admin Console Members
page. Add subscription/licenses overview, admin manage-licenses guide, and
update subscription navigation weights.
@akristen akristen self-assigned this May 27, 2026
@netlify
Copy link
Copy Markdown

netlify Bot commented May 27, 2026

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 7c3f028
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a18ab271c807b00098c0dd7
😎 Deploy Preview https://deploy-preview-25181--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions Bot added area/subscription Relates to Docker pricing and subscription area/admin Relates to Docker Admin labels May 27, 2026
docker-agent

This comment was marked as outdated.

akristen added 2 commits May 27, 2026 10:42
Relocate subscription seat management under admin/organization/manage
so it sits with other org admin tasks. Add a redirect alias for
/subscription/manage-seats/ and update cross-references across admin,
enterprise, billing, and subscription docs.
Move AI Governance and Docker Offload license overview into Scale your
subscription and remove the standalone Licenses hub page. Drop the Licenses
card from the subscription index and tweak admin org nav weights.
Simplify license assignment and automated assignment on the Members page
doc, link prerequisites to the scale page, and note that AI Governance
applies to Docker Sandbox usage.
@docker docker deleted a comment from docker-agent May 27, 2026
@docker docker deleted a comment from docker-agent May 27, 2026
@docker docker deleted a comment from docker-agent May 27, 2026
@docker docker deleted a comment from docker-agent May 27, 2026
@docker docker deleted a comment from docker-agent May 27, 2026
@docker docker deleted a comment from docker-agent May 27, 2026
@docker docker deleted a comment from docker-agent May 27, 2026
@docker docker deleted a comment from docker-agent May 27, 2026
@docker docker deleted a comment from docker-agent May 27, 2026
@akristen akristen requested review from gmondello and ob1dev May 27, 2026 19:38
docker-agent

This comment was marked as resolved.

Comment thread content/manuals/admin/organization/manage/manage-licenses.md
@akristen akristen marked this pull request as ready for review May 28, 2026 11:57
Copy link
Copy Markdown

@docker-agent docker-agent left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Assessment: 🔴 CRITICAL

4 findings: 1 high (broken anchor links), 3 medium (style, placeholder content, grammar).

For example, with an annual Docker Team subscription (500 included minutes), if you purchase 500 additional minutes, only the additional 500 minutes roll over until your annual renewal.

## Add Docker Build Cloud build minutes
### Docker Build Cloud build minutes
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[HIGH] Heading demotion breaks existing anchor links

The PR changes ## Add Docker Build Cloud build minutes (H2) to ### Docker Build Cloud build minutes (H3), and similarly for ## Add Docker Testcontainers Cloud runtime minutes. Hugo generates anchor IDs from heading text, so the old anchors #add-docker-build-cloud-build-minutes and #add-docker-testcontainers-cloud-runtime-minutes no longer exist — they become #docker-build-cloud-build-minutes and #docker-testcontainers-cloud-runtime-minutes (the add- prefix is dropped). Any internal or external pages that link to the old anchors will silently land at the top of the page instead of the intended section.

Consider adding aliases entries or updating all links that reference the old anchor IDs.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@aevesdocker How would I handle redirects for this? 🤔

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For anchor redirects in Hugo, you have two options:

Option 1: Add custom anchor IDs (recommended for this case)
Keep the new H3 structure but preserve the old anchor IDs by explicitly setting them:

### Docker Build Cloud build minutes {#add-docker-build-cloud-build-minutes}

### Docker Testcontainers Cloud runtime minutes {#add-docker-testcontainers-cloud-runtime-minutes}

This maintains the old anchors while updating the heading hierarchy.

Option 2: Hugo aliases (for page-level redirects only)
Hugo's aliases field in front matter only works for full page redirects, not anchor redirects within a page, so it won't help here.

I searched the docs repo and found no internal references to the old anchors, but external links (blogs, Stack Overflow, bookmarks) might exist. Option 1 ensures those continue working.

Comment thread content/manuals/admin/organization/manage/manage-licenses.md Outdated

## What’s next

- AI Governance
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[MEDIUM] "What's next" section contains unlinked placeholder items

Both items in the "What's next" section are bare text with no links:

- AI Governance
- Docker Offload

Docker documentation "What's next" sections are expected to contain hyperlinks to related pages. Unlinked entries provide no navigation value and appear to be placeholders for pages not yet created. Either add the destination links or remove these items until the target pages exist.

Comment thread content/manuals/subscription/scale.md Outdated
@akristen akristen requested a review from aevesdocker May 28, 2026 15:54
Copy link
Copy Markdown

@docker-agent docker-agent left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Assessment: 🟡 NEEDS ATTENTION

One medium-severity documentation issue found in the new content added by this PR. The remaining findings were low-severity style guide notes.


## What’s next

- AI Governance
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[MEDIUM] 'What's next' items are plain-text stubs with no links

Lines 43–45 of the new manage-licenses.md file list "AI Governance" and "Docker Offload" as bare bullet points with no hyperlinks:

## What's next

- AI Governance
- Docker Offload

These look like placeholder stubs that were never turned into actual links. Readers who arrive at the bottom of the page expecting navigation to the next topic will hit a dead end. Each item should link to its corresponding product page (or be removed until those pages exist).

Comment thread content/manuals/admin/organization/manage/manage-licenses.md Outdated
Comment thread content/manuals/admin/organization/manage/manage-licenses.md Outdated
Comment thread content/manuals/subscription/scale.md Outdated
akristen and others added 3 commits May 28, 2026 15:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/admin Relates to Docker Admin area/billing area/subscription Relates to Docker pricing and subscription

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants