Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

[workshop-sync] side-quest-26-01-forecast-costs.md: `gh aw forecast` experimental note is outdated; `max-daily-ai-credits` scope description is

Aperta Adatta ai principianti
  • Qualcosa non va?
#4,458 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
1/5
Tempo stimato
Meno di un'ora
Idoneità per principianti
91/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
github, markdown
Ambito
documentation

Direzione di ricerca

Modifica workshop/side-quest-26-01-forecast-costs.md, che secondo l’issue contiene entrambe le descrizioni obsolete. Leggi la Forecast Command Specification e il riferimento Cost Management collegati nell’issue, quindi aggiorna la nota sullo stato sperimentale e chiarisci che il limite di crediti di 24 ore somma le esecuzioni dello stesso workflow nell’intero repository. Il lavoro è completato quando entrambe le affermazioni corrispondono al comportamento documentato.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

documentation

Workshop file reviewed

workshop/side-quest-26-01-forecast-costs.md

Problem 1 — stale "experimental" callout

Near the top of the file:

> [!NOTE]
> gh aw forecast is currently experimental. Its flags and output format may change in future releases.

This is no longer accurate. The gh-aw Forecast Command Specification states:

"This is a Draft specification. The gh aw forecast command is a stable, generally available command; forecasts it produces are probabilistic estimates and may be inaccurate."

The spec's Change Log for Version 1.0.0 explicitly records:

  • "Promoted the gh aw forecast command out of experimental status"
  • "Removed the experimental-status stderr warning and [EXPERIMENTAL] command labels"
  • "Replaced the experimental warning ... with an accuracy-disclosure note: 'All forecasts are estimates derived from historical samples and may be inaccurate.'"

The current installed gh aw CLI help snapshot (gh aw forecast --help) also no longer shows any [EXPERIMENTAL] label, confirming this change is already live.

Current correct behaviour

gh aw forecast is stable/generally available. The workshop should either drop the "currently experimental" callout or replace it with the current accuracy-disclosure framing ("forecasts are estimates derived from historical samples and may be inaccurate").

Suggested fix

Replace the [!NOTE] block with something like:

> [!NOTE]
> gh aw forecast is a stable command, but its output is a statistical estimate — treat P10/P50/P90 figures as probabilistic projections, not guarantees.

Problem 2 — incorrect scope description for max-daily-ai-credits

In the "Translate the P90 into max-daily-ai-credits" section:

"The max-daily-ai-credits field caps how many AIC a workflow can consume across the last 24 hours for the triggering user."

This is incorrect. Per the gh-aw Cost Management reference:

"Use max-daily-ai-credits to set a 24-hour AI Credits cap for one workflow. The guardrail sums runs from the past 24 hours of the same workflow across the repository, regardless of who triggered them."

So the cap applies per-workflow, repository-wide — not scoped to an individual triggering user.

Current correct syntax/behaviour

max-daily-ai-credits sums AIC usage for a given workflow across all triggers in the repository over the trailing 24-hour window, not just the user who triggered the current run.

Suggested fix

Update the sentence to:

"The max-daily-ai-credits field caps how many AIC a workflow can consume across the last 24 hours, summed across all runs of that workflow in the repository regardless of who triggered them."

Generated by 🔍 Workshop Sync Check · copilot · auto · 140.7 AIC · ⌖ 9.31 AIC · ⊞ 9.2K · ◷

  • expires on Oct 12, 2026, 10:47 AM UTC
Lingua principale
JavaScript
Stelle
52
Fork
26
Merge medio
12h 58m
PR unite (30g)
15

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

  • Nessun Dockerfile né file Docker Compose
  • Nessun modello di pull request
  • Nessuna guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di githubnext/gh-aw-workshop

Tutte le issue di githubnext/gh-aw-workshop

Issue simili

Altre issue su JavaScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.