Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

[docs-scanner] Outdated urgency framing for GitHub Cache API v2 migration

Aberta Para iniciantes
  • Algo errado?
#26,466 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
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
68/100
Tipo de issue
Documentação
Clareza
Razoavelmente clara
Status de atividade
Ativa
Stack de tecnologia
markdown
Domínio
documentation

Direção de pesquisa

Leia content/manuals/build/ci/github-actions/cache.md e verifique o aviso de sunset da GitHub Cache API v2 vinculado para confirmar o status do prazo. Atualize a redação temporal do callout e avalie se sua seção de troubleshooting ainda é necessária; concluído quando a página fornecer aos leitores orientação atual inequívoca sobre a API v2 e qualquer ação necessária.

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

Descrição

File: content/manuals/build/ci/github-actions/cache.md

Issue

The "Important" callout about GitHub Cache API v2 migration uses urgent language that suggests this is a current/imminent issue, but the deadline mentioned is "April 15th, 2025":

As of April 15th, 2025, only GitHub Cache service API v2 is supported.. The legacy v1 API has been shut down.

The framing "As of April 15th, 2025" combined with "has been shut down" creates confusion about whether this is:

  • A future event (the date is in the future from when this was written)
  • A past event (the "has been shut down" language)
  • Current guidance (the "Important" callout suggests urgency)
Why this matters

Readers encountering this in late 2025 or 2026 will be confused about whether this is still relevant or if they need to take action. The temporal framing makes it unclear whether the migration deadline has passed or is approaching. If the deadline has already passed, the urgent tone and troubleshooting guidance for "outdated tools" may no longer be necessary for most users.

Suggested fix

If the April 15, 2025 deadline has passed:

  • Remove or simplify the "Important" callout
  • Reframe as historical context: "GitHub Cache service API v2 is required. The legacy v1 API was shut down on April 15, 2025."
  • Consider whether the extensive troubleshooting section is still needed, or if it should be condensed

If the deadline is still future:

  • Use clearer temporal language: "Starting April 15, 2025, only GitHub Cache service API v2 will be supported."
  • Change "has been shut down" to "will be shut down"

Found by nightly documentation quality scanner

Linguagem predominante
Markdown
Estrelas
4.7k
Forks
8.5k
Merge médio
1d 22h
PRs com merge (30d)
148

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.