Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Broken default fallback URL in community-lists shortcode resulting in 404 links

Abierto Apto para principiantes
  • ¿Algo no está bien?
#182 1 comentario 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
1/5
Tiempo estimado
Menos de una hora
Aptitud para principiantes
88/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Tranquilo
Área
documentation

Línea de trabajo

Abre layouts/_shortcodes/community-lists.md e inspecciona la URL de fallback en la línea 2 y su uso en la línea 23. Actualiza el fallback a la ruta documentada /docs/contributing/, luego renderiza el shortcode community-lists sin contributingUrl y verifica que el enlace generado resuelva a la página Contributing.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Problem

In layouts/_shortcodes/community-lists.md, line 2 configures the fallback URL for contribution guidelines when .Page.Params.contributingUrl is omitted from page front-matter:

{{ $contribUrl := .Page.Params.contributingUrl | default "docs/contribution-guidelines" -}}

However, docs/contribution-guidelines does not exist in the site repository. The actual contribution documentation page is located at content/en/docs/contributing.md (which renders to /docs/contributing/).

Root Cause
  1. Line 2 of layouts/_shortcodes/community-lists.md hardcodes "docs/contribution-guidelines" as the default fallback parameter.
  2. The site documentation structure uses /docs/contributing/ for contribution guidelines.
  3. If the contributingUrl front-matter parameter is omitted or removed from a page rendering the {{% community-lists %}} shortcode, the shortcode generates a link to /docs/contribution-guidelines/, which returns a 404 Not Found error.
Affected Components
  • layouts/_shortcodes/community-lists.md
Reproduction / Evidence
  1. Inspect layouts/_shortcodes/community-lists.md line 2 and line 23: 
    {{ $contribUrl := .Page.Params.contributingUrl | default "docs/contribution-guidelines" -}}
...
[{{ T "community_guideline" }}]({{ $contribUrl | relURL }}).
  2. Note that git ls-files content/en/docs/ contains content/en/docs/contributing.md (rendered at /docs/contributing/), while /docs/contribution-guidelines does not exist.
Acceptance Criteria
  • Update the default fallback URL in layouts/_shortcodes/community-lists.md from "docs/contribution-guidelines" to "/docs/contributing/".
  • Verify that community-lists renders valid, resolving links to the Contributing page even when contributingUrl is omitted from front matter.
Proposed Solution Direction

Update line 2 of layouts/_shortcodes/community-lists.md to fallback to "/docs/contributing/":

{{ $contribUrl := .Page.Params.contributingUrl | default "/docs/contributing/" -}}
Lenguaje dominante
HTML
Estrellas
25
Forks
46
Sin PR fusionados en 30 d

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de theupdateframework/theupdateframework.io

Todos los issues de theupdateframework/theupdateframework.io

Issues similares

Más issues de Documentation

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.