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

Generated feature_requirements and traceability_report pages reference existing images at paths that are not staged

Abierto
  • ¿Algo no está bien?
#334 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 2 días

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
52/100
Tipo de issue
Error
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
rust
Área
documentation, tooling

Línea de trabajo

El issue apunta a la documentación de score_tooling y a la generación de informes, al cálculo de rutas de artefactos y a la generación de informes multipágina de Lobster RST; empieza siguiendo cómo image_srcs se convierte en una salida preparada y en rutas de imágenes emitidas para ambos tipos de página. Reproduce las advertencias image.not_readable con una imagen existente y, después, verifica que las salidas de feature_requirements y traceability_report resuelvan sus imágenes referenciadas sin advertencias.

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

Descripción

Summary

Images referenced from requirement text exist and are declared via image_srcs, but generated documentation pages still emit image.not_readable warnings because the generated output tree does not stage them at the paths used by the generated RST.

Observed behavior

Two related cases were observed:

  1. feature_requirements pages
    Generated pages reference paths like:
    feature_requirements/img/<name>.png

    but staged outputs land under deeper transitive paths or different locations.

  2. traceability_report pages
    Generated Lobster RST pages keep .. image:: ... directives from requirement text, but the corresponding images are not copied into the generated traceability_report/... tree at all.

Expected behavior

If an image is referenced from requirement text and provided through image_srcs, generated pages should be able to resolve it without image.not_readable warnings.

Why this looks like a tooling bug

  • The source images exist in the repo.
  • The warnings persist in generated pages, not because the source files are missing, but because generated staging paths do not match emitted image references.
  • The mismatch appears after score_tooling doc generation / report generation.

Impact

Migrated requirements with valid inline images produce noisy warnings and partially broken generated docs even when the images are present and wired.

Notes

This issue is distinct from genuinely missing source images.
The bug here is specifically about existing images not being staged where generated pages expect them.

Suspected areas

  • artifact path computation for requirement doc staging
  • Lobster RST multi-page report generation and asset copying
Lenguaje dominante
Rust
Estrellas
8
Forks
37
Merge medio
1 d 9 h
PR fusionados (30 d)
22

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

  • Sin Dockerfile ni archivo de Docker Compose
  • Sin plantilla de pull request
  • Sin guía de contribución

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 eclipse-score/tooling

Todos los issues de eclipse-score/tooling

Issues similares

Más issues de Rust

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.