Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem 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

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#4,458 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
1/5
Thời gian dự kiến
Dưới một giờ
Mức phù hợp với người mới
91/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
github, markdown
Lĩnh vực
documentation

Hướng nghiên cứu

Chỉnh sửa workshop/side-quest-26-01-forecast-costs.md, tệp mà issue xác định là chứa cả hai mô tả đã lỗi thời. Đọc Forecast Command Specification và tài liệu tham khảo Cost Management được liên kết trong issue, sau đó cập nhật ghi chú về trạng thái thử nghiệm và làm rõ rằng giới hạn credit trong 24 giờ cộng dồn các lần chạy của cùng một workflow trên toàn bộ repository. Hoàn tất khi cả hai phát biểu khớp với hành vi được tài liệu hóa.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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
Ngôn ngữ chính
JavaScript
Star
55
Fork
36
Merge trung bình
1 ngày 6 giờ
Pull request đã merge (30 ngày)
15

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

  • Không có Dockerfile hay tệp Docker Compose
  • Không có mẫu pull request
  • Không có hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của githubnext/gh-aw-workshop

Tất cả issue của githubnext/gh-aw-workshop

Issue tương tự

Thêm issue về JavaScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.