Harden flaky nginx content-type smoke test in Docs build (child-repo .md routes)
Los mantenedores suelen responder en 1 día
@B4nan ya está trabajando en esto.
Desde el 28/7/2026.
Evaluación
Este issue todavía no se ha evaluado.
Descripción
What needs to change
The post-build nginx smoke test in .github/workflows/test.yaml (the 🧪 Checking Nginx responses... block) asserts content types with single-shot curls and no retry — assert_header and assert_final_content_type. A single transient response fails the whole Docs build job.
Add a bounded retry with backoff (e.g. 3 attempts ~2s apart) inside those two helpers, so a one-off blip is absorbed while a genuinely broken route still fails every attempt (coverage unchanged).
Why
The check intermittently red-Xes unrelated PRs. On #2827 it failed on:
assert_header ".../sdk/python/docs/changelog.md" "Content-Type" "text/markdown"
❌ got text/html
It's demonstrably nondeterministic: two consecutive builds on that branch — the baseline commit passed this assertion, a README-only commit failed it, and a plain re-run (no code change) went green. Master is not persistently affected. Each occurrence costs a manual re-run and erodes trust in the required checks.
Scope note: retry is the pragmatic fix. The deeper root cause — why a child-repo .md variant occasionally serves text/html before the markdown variant is ready — may deserve separate investigation into the nginx content-negotiation / try_files for child repos.
Source
- Flaky failure on #2827 (failed run, passed on re-run).
- Assertion helpers:
.github/workflows/test.yaml. - Content-negotiation check originally added in #2032.
- Lenguaje dominante
- JavaScript
- Estrellas
- 82
- Forks
- 240
- Merge medio
- 4 d 2 h
- PR fusionados (30 d)
- 44
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Tiene una plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de apify/apify-docs
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 85/100
apify/apify-docs#3071 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 85/100
apify/apify-docs#3049 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
apify/apify-docs#2742 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 1-3 horas Aptitud para principiantes 82/100
apify/apify-docs#2741 ·
Los mantenedores suelen responder en 1 día
-
low priority t-unblocking tech enhancement
Dificultad 2/5 1-3 horas Aptitud para principiantes 65/100
apify/apify-docs#2451 ·
Los mantenedores suelen responder en 1 día
Todos los issues de apify/apify-docs
Issues similares
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 82/100
nodejs/node#66743 · 1 reacción ·
Los mantenedores suelen responder en 1 día
-
enhancement good first issue help wanted
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
OWASP/cve-lite-cli#1335 ·
Los mantenedores suelen responder en 1 día
-
Channels status: needs triage
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100
mastra-ai/mastra#27093 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
category/development priority/P1 scope/ci-cd scope/testing status/ready-for-agent type/bug
Dificultad 1/5 Menos de una hora Aptitud para principiantes 72/100
QwenLM/qwen-code#14225 · 3 comentarios ·
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 82/100