[docs-scanner] Broken relative links in Docker Agent documentation

Aberta Para iniciantes
  • Algo errado?
#26,567 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
1/5
Tempo estimado
Menos de uma hora
Facilidade para iniciantes
84/100
Tipo de issue
Bug
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
github, markdown
Domínio
documentation

Direção de pesquisa

Abra content/manuals/ai/docker-agent/_index.md e examine os cinco links relativos mencionados na issue; as páginas de destino estão descritas como estando na pasta docs/ do repositório docker-agent. Confira esses caminhos em relação aos destinos sugeridos e atualize os links para que os leitores possam acessar os guias referenciados. A tarefa estará concluída quando os cinco links apontarem para a documentação pretendida.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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:

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:

  1. ./configuration/overview/index.md → https://github.com/docker/docker-agent/blob/main/docs/configuration/overview/index.md
  2. ./getting-started/quickstart/index.md → https://github.com/docker/docker-agent/blob/main/docs/getting-started/quickstart/index.md
  3. ./guides/tips/index.md → https://github.com/docker/docker-agent/blob/main/docs/guides/tips/index.md
  4. ./features/acp/index.md → https://github.com/docker/docker-agent/blob/main/docs/features/acp/index.md
  5. ./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

Linguagem predominante
Markdown
Estrelas
4.7k
Forks
8.5k
Merge médio
2d 8h
PRs com merge (30d)
129

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de docker/docs

Todas as issues de docker/docs

Issues semelhantes

Mais issues de Documentation

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.