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

Download page builds SHA-512/signature links from artifact-root instead of checksum-root

Abierto Apto para principiantes
  • ¿Algo no está bien?
#185 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
75/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
css, html, jekyll
Área
documentation, web-dev

Línea de trabajo

El issue está en el archivo download.md en las líneas 51-52. Primero, ubique el directorio _releases/ del repositorio para comprender la estructura de datos de las versiones (buscando checksum-root y artifact-root). Modifique la plantilla para usar release.checksum-root en los href de los enlaces SHA-512 y de Firma. Pruebe compilando el sitio de Jekyll localmente y verificando que los enlaces generados apunten a downloads.apache.org y devuelvan archivos de texto plano/firma, no HTML.

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

Descripción

The SHA-512 and Signature columns on the download page link to the mirror selector rather than the canonical distribution host, so they return an HTML mirror-selection page instead of the file.

Reproduction

on https://nuttx.apache.org/download/, click any current release's SHA-512 link (e.g. 13.0.1). curl shows the difference:

Generated: https://www.apache.org/dyn/closer.lua/nuttx/12.12.0/apache-nuttx-12.12.0.tar.gz.sha512 → 200 text/html, ~21 KB mirror-picker page
Canonical: https://downloads.apache.org/nuttx/12.12.0/apache-nuttx-12.12.0.tar.gz.sha512 → 200 text/plain, 158 bytes (the hash)
Same for .asc: the generated URL returns the ~21 KB HTML page; the downloads.apache.org URL returns the 833-byte PGP signature.

Root cause:

download.md:51-52 builds the .sha512/.asc hrefs from release.artifact-root. Every release file defines checksum-root (and key-file) for exactly this purpose — present since the first Apache release file (be0ee1f, 9.0.0, May 2020) — but no template reads them; the same commit wired the columns to artifact-root instead. A repo-wide grep confirms checksum-root/key-file are write-only (only other hit is the dormant generator helpers/syncbbrelease.py).

Scope:

affects all mirror-served Apache releases (9.1.1, 10.0.1, 10.1.0–13.0.1). Archive rows (9.0.0, 9.1.0, 10.0.0) have checksum-root == artifact-root, so they are unaffected and need no special handling. The page text itself (download.md:68-69) already states hashes/signatures are hosted at Apache, and the closer.lua page advises fetching signatures from the main distribution site rather than a mirror.

Proposed fix (scoped to download.md:51-52 only): build the SHA-512 and Signature hrefs from release.checksum-root, leaving the Archive column on artifact-root. Suggested regression check: assert built SHA/ASC hrefs start with each release's checksum-root and return non-HTML 200s.

Lenguaje dominante
CSS
Estrellas
24
Forks
37
Merge medio
1 h 39 min
PR fusionados (30 d)
1

Preparar el entorno

Aún no hemos revisado los archivos de configuración de este proyecto. 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 apache/nuttx-website

Todos los issues de apache/nuttx-website

Issues similares

Más issues de Documentation

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.