Sitemap gives 1,003 generated reference pages a lastmod of 0001-01-01
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 2/5
- Tiempo estimado
- 1-3 horas
- Aptitud para principiantes
- 74/100
- Tipo de issue
- Error
- Claridad
- Bien especificado
- Estado de actividad
- Activo
- Stack tecnológico
- hugo
- Área
- documentation
Línea de trabajo
Comienza por layouts/sitemap.xml y luego inspecciona las páginas generadas por content/reference/cli/_content.gotmpl y el comportamiento de GitInfo de Hugo. Ejecuta o inspecciona el sitemap.xml generado antes de cambiar la plantilla; la tarea estará terminada cuando las páginas de referencia generadas ya no expongan <lastmod> como 0001-01-01, mientras que las fechas válidas se mantengan intactas. Consulta el enfoque con los responsables porque el issue menciona un pull request anterior cerrado y una alternativa.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Is this a docs issue?
- My issue is about the documentation content or website
Type of issue
There's a problem with the website
Description
The sitemap gives 1,003 of its 2,204 entries a <lastmod> of 0001-01-01. For example, docker container run:
<loc>https://docs.docker.com/reference/cli/docker/container/run/</loc>
<lastmod>0001-01-01</lastmod>
Every affected page is a generated reference page: the docker and sbx CLI references, and the Sandboxes, Hub, DVP, AI Governance and Registry API references. Anything that reads the sitemap takes that date at face value, so these pages look like they never change.
As far as I can tell, the cause is that these pages are built by Hugo content adapters such as content/reference/cli/_content.gotmpl, so they have no file in git. With enableGitInfo: true, Hugo takes Lastmod from git, so for these pages it stays at Go's zero time, and layouts/sitemap.xml prints it as is.
Location
https://docs.docker.com/sitemap.xml
Suggestion
One fix is to leave <lastmod> out when the date is zero, which is what Hugo's embedded sitemap template does. The element is optional in the sitemap protocol.
I opened #26365 with that change before filing an issue, which in hindsight was the wrong order. It's closed, and I'm filing this so the problem is tracked either way. I'm happy to rework it if you'd prefer a different approach, such as having the content adapters set a date, or to leave the fix to you.
- Lenguaje dominante
- Markdown
- Estrellas
- 4.7k
- Forks
- 8.5k
- Merge medio
- 2 d 7 h
- PR fusionados (30 d)
- 133
Preparar el entorno
- Incluye un Dockerfile o un 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 docker/docs
-
Dificultad 1/5 1-3 horas Aptitud para principiantes 82/100
Los mantenedores suelen responder en 1 día
-
status/triage
Dificultad 1/5 Menos de una hora Aptitud para principiantes 68/100
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 Medio día Aptitud para principiantes 82/100
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
Los mantenedores suelen responder en 1 día
-
status/triage
Dificultad 1/5 Menos de una hora Aptitud para principiantes 88/100
Los mantenedores suelen responder en 1 día
Todos los issues de docker/docs
Issues similares
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 73/100
-
Missing options in yara man pageAbiertobug
Dificultad 1/5 Menos de una hora Aptitud para principiantes 84/100
VirusTotal/yara#2255 ·
-
area:arcade p3-medium ready-for-agent testing type:docs
Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100
fderuiter/deruiter.dev#2369 ·
Los mantenedores suelen responder en 1 día
-
Browser Tests page: the template's tests no longer use the sample content (components-web-app#177)Abierto
Dificultad 1/5 1-3 horas Aptitud para principiantes 88/100
components-web-app/docs#267 ·
-
bug documentation
Dificultad 2/5 1-3 horas Aptitud para principiantes 65/100
r-lib/rig#483 · 1 comentario ·
Los mantenedores suelen responder en 1 día