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

The tip-manual gate passes when tips appear outside the tips table

Đang mở
#1,480 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ó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
82/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
go
Lĩnh vực
documentation, testing

Hướng nghiên cứu

Start in internal/tui3/hometip_test.go:237 and inspect the table under ## Every hint codeaf can show in internal/manual/chat/hints-and-tips.md. Run go test ./internal/tui3 -run TestEveryTipIsOnTheManualPage -count=1, then use the two described counterexamples to verify the gate checks the table's contents and order. Done means the current table passes and both counterexamples fail, with the invalidates change entry corrected.

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

Mô tả

area:tests bug hygiene sev:papercut

Seen on dev@debffabf6. Surfaced while verifying #1389; introduced by it.

What happened

TestEveryTipIsOnTheManualPage checks manual.Chat().Mentions(n.text) for each tip. That searches the whole chat corpus, so a tip can be deleted from the hints-and-tips.md table, moved out of order, or appear only in another page while the gate stays green. The change entry and manual describe a stronger, word-for-word table contract.

Replication

Deterministic (no model). In a disposable checkout, move one tip line out of the table section into another chat page, then run go test ./internal/tui3 -run TestEveryTipIsOnTheManualPage -count=1. The test still passes because the words remain somewhere in the corpus. Restore the checkout afterward. Reorder two table lines for a second passing counterexample.

Where

internal/tui3/hometip_test.go:237 at dev@debffabf6 uses corpus-wide Mentions. The table is in internal/manual/chat/hints-and-tips.md under ## Every hint codeaf can show.

The fix

Read that exact table section, parse its ordered tip lines, and compare them with the code's ordered tip list.

Acceptance

  • e2e: a documentation command or targeted test fails if a visible tip is absent from the table or its order changes without a matching code change.
  • Unit: the gate rejects the two counterexamples above and accepts the current table.
  • Correct the change entry's gate claim in invalidates.
Ngôn ngữ chính
Go
Star
115
Fork
14
Merge trung bình
9 giờ 38 phút
Pull request đã merge (30 ngày)
749

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

Chúng tôi chưa kiểm tra các tệp thiết lập môi trường của dự án này. Hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

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 Agent-Field/CodeAF

Tất cả issue của Agent-Field/CodeAF

Issue tương tự

Thêm issue về Go

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.