[docs-scanner] Contradictory information about default docker driver support for cache backends
Nobody has claimed this yet.
- Dominant language
- Markdown
- Stars
- 4.7k
- Forks
- 8.5k
- Avg merge
- 2d 18h
- Merged PRs (30d)
- 108
Description
Files:
content/manuals/build/cache/backends/_index.mdcontent/manuals/build/cache/backends/gha.mdcontent/manuals/build/cache/backends/registry.md
Issue
The documentation contradicts itself about whether the default docker driver supports certain cache backends.
In _index.md (lines 18-21):
The default
dockerdriver supports theinline,local,registry, andghacache backends, but only if you have enabled the containerd image store.
In gha.md (lines 11-13):
This cache storage backend is not supported with the default
dockerdriver. To use this feature, create a new builder using a different driver.
In registry.md (lines 15-17):
This cache storage backend is not supported with the default
dockerdriver. To use this feature, create a new builder using a different driver.
Why this matters
A reader trying to use the GitHub Actions cache or registry cache with the default docker driver will get conflicting information:
- The overview page tells them it IS supported (with containerd enabled)
- The specific backend pages tell them it is NOT supported and they must create a new builder
This directly contradicts the reader's ability to determine whether they need to create a new builder or can use their existing default driver.
Suggested fix
Determine which statement is correct:
Option 1: If the default docker driver DOES support these backends with containerd:
- Remove or update the warning in
gha.mdandregistry.mdto match_index.md - Consider adding a note about requiring containerd image store
Option 2: If the default docker driver does NOT support these backends:
- Update
_index.mdto removeregistryandghafrom the list of supported backends - Keep the warnings in the individual backend pages
Note: local.md and inline.md do not have this warning, which is consistent with _index.md saying they are supported.
Found by nightly documentation quality scanner
Contributor 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.
Research direction
Compare the stated driver support in content/manuals/build/cache/backends/_index.md, gha.md, and registry.md, then verify the correct behavior for the default Docker driver with the containerd image store. Update the affected documentation so the overview and backend pages agree and clearly state whether a separate builder is required.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- docker
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 52/100