[docs-scanner] Broken relative links in Docker Agent documentation
Maintainer antworten meist innerhalb von 1 Tag
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 1/5
- Geschätzter Aufwand
- Unter einer Stunde
- Anfängerfreundlichkeit
- 84/100
- Issue-Typ
- Bug
- Klarheit
- Klar beschrieben
- Aktivitätsstatus
- Aktiv
- Tech-Stack
- github, markdown
- Bereich
- documentation
Rechercherichtung
Öffne content/manuals/ai/docker-agent/_index.md und prüfe die fünf relativen Links, die im Issue genannt werden. Die Zielseiten sollen sich im Ordner docs/ des docker-agent-Repositorys befinden. Vergleiche diese Pfade mit den vorgeschlagenen Zielen und aktualisiere die Links, damit Leser die referenzierten Anleitungen erreichen können. Fertig ist die Aufgabe, wenn alle fünf Links zur vorgesehenen Dokumentation führen.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
File: content/manuals/ai/docker-agent/_index.md
Issue
The "What's next" section and "Configuration options" section contain five broken relative links that point to non-existent documentation paths within the docs repository:
- Follow the quickstart to build your first agent
- Learn best practices for building effective agents
- Integrate Docker Agent with your editor or use agents as
tools in MCP clients- Read the full configuration reference
And in the "Configuration options" section:
See the configuration reference for complete details.
These paths do not exist in content/manuals/ai/docker-agent/ — the directory only contains _index.md.
Why this matters
Readers clicking these links encounter 404 errors, preventing them from accessing essential documentation for:
- Getting started with Docker Agent
- Learning best practices
- Understanding configuration options
- Using advanced features (ACP, MCP integration)
This blocks users from progressing beyond the basic overview.
Suggested fix
The documentation exists in the docker-agent GitHub repository under the docs/ folder. Update all five links to point to the GitHub repository:
./configuration/overview/index.md→https://github.com/docker/docker-agent/blob/main/docs/configuration/overview/index.md./getting-started/quickstart/index.md→https://github.com/docker/docker-agent/blob/main/docs/getting-started/quickstart/index.md./guides/tips/index.md→https://github.com/docker/docker-agent/blob/main/docs/guides/tips/index.md./features/acp/index.md→https://github.com/docker/docker-agent/blob/main/docs/features/acp/index.md./tools/mcp/index.md→https://github.com/docker/docker-agent/blob/main/docs/tools/mcp/index.md
Alternatively, if the plan is to migrate this documentation into docs.docker.com, the links should be removed or marked as "coming soon" until the content is available.
Found by nightly documentation quality scanner
- Vorherrschende Sprache
- Markdown
- Sterne
- 4.7k
- Forks
- 8.5k
- Ø Merge
- 2 T. 8 Std.
- Gemergte PRs (30 T.)
- 129
Entwicklungsumgebung
- Enthält ein Dockerfile oder eine Docker-Compose-Datei
- Hat eine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus docker/docs
-
[docs-scanner] Inconsistent information about what gets deleted when Docker Offload v1 session endsEvtl. wieder frei Ein Pull Request dazu wurde ohne Merge geschlossen. Offen
Schwierigkeit 1/5 1-3 Stunden Anfängerfreundlichkeit 88/100
Maintainer antworten meist innerhalb von 1 Tag
-
status/triage
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 92/100
Maintainer antworten meist innerhalb von 1 Tag
-
[docs-scanner] Confusing explanation of approval-required outcome vs permit in MCP policyEvtl. vergeben @dave123981 hat das vor 2 Tagen übernommen. Offen
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 88/100
Maintainer antworten meist innerhalb von 1 Tag
-
[docs-scanner] Contradictory information about MCP approval fields in audit recordsEvtl. vergeben @dave123981 hat das vor 2 Tagen übernommen. Offen
Schwierigkeit 1/5 1-3 Stunden Anfängerfreundlichkeit 88/100
Maintainer antworten meist innerhalb von 1 Tag
-
status/triage
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 68/100
Maintainer antworten meist innerhalb von 1 Tag
Ähnliche Issues
-
🧩 Docs job fails type-checking `generate-plugin-docs.ts`Evtl. vergeben @X-Guardian hat das heute übernommen. Offendiscussion
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 84/100
Maintainer antworten meist innerhalb von 1 Tag
-
Installation guide's prerequisites leave out ca-certificates, which a no-recommends system needsOffenbot-found documentation priority: P3
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 94/100
madenvel/KalinkaPlayer#544 ·
-
14.3.x
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100
-
bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100
githubnext/gh-aw-workshop#5522 ·
Maintainer antworten meist innerhalb von 1 Tag