[docs-scanner] Inconsistent terminology for Gordon's free tier across pages
Maintainers usually reply within 1 day
@zainab-oladimeji is already working on this.
Since Oct 23, 2026.
- #26420 by @zainab-oladimeji — open
Assessment
- Difficulty
- 1/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 92/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- markdown
- Domain
- documentation
Research direction
The issue names content/manuals/ai/gordon/usage-limits.md and content/manuals/ai/gordon/concepts/data-privacy.md. Read both headings and tier references, then update the data privacy heading to use consistent Base terminology. Done when readers can identify the same free tier across both pages.
Written by the indexing model from the issue text.
Description
Files:
content/manuals/ai/gordon/usage-limits.mdcontent/manuals/ai/gordon/concepts/data-privacy.md
Issue
The Gordon documentation uses inconsistent terminology to refer to the free tier across different pages.
In usage-limits.md, the free tier is consistently called "Base":
Gordon is included with every Docker account at the Base tier. Paid Gordon plans unlock higher usage limits.
And in the table:
| Base | Included with any Docker account |
However, in data-privacy.md, the same tier is called "Personal (free) subscription":
Personal (free) subscription
Anonymized conversation threads are stored for 5 days to help guarantee quality of service and fight abuse.
Why this matters
Readers trying to understand which tier they're on and what data retention policies apply to them will encounter two different names for the same tier. This creates confusion about whether "Base" and "Personal (free)" are the same thing or different tiers with different policies.
A reader on the free tier might:
- Read usage-limits.md and learn they're on "Base" tier
- Read data-privacy.md looking for "Base" tier data policies
- Find only "Personal (free) subscription" and wonder if it applies to them
Suggested fix
Use consistent terminology across both pages. Since "Base" is used throughout usage-limits.md and appears to be the primary term, update data-privacy.md to use "Base tier" or "Base (free) tier" instead of "Personal (free) subscription".
Change:
### Personal (free) subscription
To:
### Base tier (free)
Or add a clarification:
### Base tier (Personal free subscription)
Found by nightly documentation quality scanner
- Dominant language
- Markdown
- Stars
- 4.7k
- Forks
- 8.5k
- Avg merge
- 2d 5h
- Merged PRs (30d)
- 145
Getting set up
- Ships a Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from docker/docs
-
status/triage
Difficulty 1/5 Under an hour Newbie friendliness 82/100
Maintainers usually reply within 1 day
-
[docs-scanner] Example uses deprecated Flocker volume driverPossibly taken @aevesdocker claimed this 4 days ago. Open
Difficulty 1/5 1-3 hours Newbie friendliness 82/100
docker/docs#26376 · 1 assignee ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 Half a day Newbie friendliness 82/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Maintainers usually reply within 1 day
-
status/triage
Difficulty 1/5 Under an hour Newbie friendliness 88/100
Maintainers usually reply within 1 day
Similar issues
-
needs-triage Technical TODO
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
Maintainers usually reply within 2 days
-
aggfuncOpen
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
worldbank/blackmarblepy#160 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 91/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
theforeman/foreman-documentation#5529 ·
Maintainers usually reply within 2 days
-
Difficulty 1/5 1-3 hours Newbie friendliness 88/100
fossasia/visdom-dev#69 ·
Maintainers usually reply within 3 days