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

[workshop-sync] workshop/side-quest-20-01-memory-patterns.md: invalid `ttl` field and inaccurate repo-memory storage description

Cerrado Apto para principiantes
#4,686 0 comentarios 0 reacciones 0 asignados Ver en GitHub

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
86/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
github-actions, markdown

Línea de trabajo

Comienza con workshop/side-quest-20-01-memory-patterns.md y compara sus afirmaciones sobre ttl, repo-memory y los permisos con las referencias vinculadas cache-memory y repo-memory. Para el aviso sobre permisos, localiza el archivo lock compilado relevante y el job push generado antes de modificar la guía. La página estará terminada cuando las tres afirmaciones coincidan con el comportamiento documentado, incluida la expulsión de la caché y el almacenamiento basado en ramas.

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

Descripción

documentation

Workshop file reviewed

workshop/side-quest-20-01-memory-patterns.md (reviewed against gh-aw v0.92.0 docs)

Problems

  1. ttl is not a cache-memory field. The frontmatter example and field table use:

    ttl: 7d — How long to keep cached data without a refresh... Common values: 1d, 7d, 30d.

    The cache-memory reference documents only key and retention-days (1-90). retention-days controls uploaded artifact retention only and does not extend cache lifetime. GitHub Actions evicts unused cache entries after 7 days regardless.

  2. repo-memory is not "a file committed to your repository". The page says:

    repo-memory backs a memory slot with a JSON file committed directly to your repository. The agent reads the file at the start of each run and commits an updated version at the end.

    The repo-memory reference says it stores files on a dedicated Git branch (default memory/default, mounted at /tmp/gh-aw/repo-memory-default/). The compiler auto-commits and pushes after the run. Files can be any allowed type, not just one JSON file. The table row "A file committed to your repository" and the "survives a repository clone" scenario should be reviewed for the same reason, since a branch needs to be fetched.

  3. The contents: write claim is not supported by the docs. The [!IMPORTANT] callout says repo-memory requires contents: write in the workflow's permissions. The reference doesn't state this, because the compiler generates the push job. Please verify against a compiled lock file and fix or remove the callout.

Suggested fix

  • Replace ttl: 7d with retention-days: 7 (or remove it), and rewrite the field-table row to describe artifact retention only. Say that cache lifetime is governed by Actions eviction (about 7 days unused).
  • Describe repo-memory as Git-branch storage (memory/default) with unlimited retention.
  • Re-verify and correct the permission callout.

Other files in this run

side-quest-21-01-sub-agent-syntax.md and side-quest-22-01-failure-modes.md had no blocking issues. Optional improvement for 21-01: mention the explicit ## end agent: \name`` marker.

Generated by 🔍 Workshop Sync Check · copilot · auto · 25.6 AIC · ⌖ 0.554 AIC · ⊞ 9.2K · ◷

  • expires on Oct 18, 2026, 1:33 PM UTC
Lenguaje dominante
JavaScript
Estrellas
55
Forks
36
Merge medio
2 d 8 h
PR fusionados (30 d)
17

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 githubnext/gh-aw-workshop

Todos los issues de githubnext/gh-aw-workshop

Issues similares

Más issues de JavaScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.