Skip to content

[docs-scanner] Legacy subscription tabs suggest ongoing transition #24305

@docker-agent

Description

@docker-agent

File: content/manuals/subscription/change.md

Issue

The documentation uses tabbed content to separate "Docker subscription" and "Legacy Docker subscription" instructions throughout the page. This pattern suggests an ongoing transition or migration period, but it's unclear whether legacy subscriptions are still being actively used or if this is historical documentation.

The tabs appear in multiple sections:

  • Upgrade your subscription
  • Downgrade your subscription

This creates ambiguity about:

  1. Whether new users might have legacy subscriptions
  2. How long these legacy instructions need to remain
  3. Whether the transition is complete

Suggested fix

Clarify the status of legacy subscriptions:

  1. If legacy subscriptions are no longer active, remove the legacy tabs and add a brief note at the top: "If you have a legacy Docker subscription (purchased before [date]), see [legacy documentation link]"
  2. If legacy subscriptions are still active, add context explaining what qualifies as a legacy subscription and when/how users should migrate
  3. Consider adding a deprecation notice if legacy subscriptions will be phased out

Found by nightly documentation freshness scanner

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions