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

Site: the theme-locked --code-comment grey (#6a6f80) on the dark code surface is 3.8:1, below WCAG AA, in both themes (F-W1-SITE-06)

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#887 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

@vortsghost2025 đang làm issue này rồi.

Từ ngày 13/10/2026.

  • #937 của @vortsghost2025 — đang mở

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
66/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ệ
css
Lĩnh vực
accessibility, design

Hướng nghiên cứu

Bắt đầu với token --code-comment tại site/css/style.css:56 và khối theme sáng tại :115, khối này giữ --code-bg ở màu tối. Các quy tắc màu chữ trên bề mặt code nằm ở :1061, :1095, :1366, :1390, :1401 và :2051. Kiểm tra độ tương phản của #7a8090 so với #0d1018 (issue báo cáo 4,8:1), sau đó xác nhận mọi màu chữ được liệt kê đạt 4,5:1 ở cả hai theme. Phối hợp với #683 (CR-A18-055), issue bao quát các token --text-muted liên quan.

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

Mô tả

area: site bug good first issue severity: low source: review-2026-09 wave: 4

Wave 4 · group W4 Module sweep · highest severity Low · 1 finding(s) · effort small

Summary

Code comments in code blocks and terminal mock-ups, and the small bar titles, language tags and copy buttons on the code surface, use --code-comment: #6a6f80 on --code-bg: #0d1018 — a 3.80:1 contrast ratio, below the 4.5:1 WCAG AA minimum for normal text. The code surface stays dark in light mode as well, so both themes are affected, while site/README.md:105 claims AA on both.

Primary finding

F-W1-SITE-06 — Code-surface comment and label text falls below the AA contrast floor

severity Low (rated Medium by the source review; Low here to match CR-A18-055 in #683, which it should be fixed with) · confidence high · computed from the CSS tokens

What happens. site/css/style.css:56 defines --code-comment; the light theme does not redefine it and keeps --code-bg dark (site/css/style.css:115). The token colours .terminal-body .comment (:1095), .code-block-body .comment (:1390) and the 0.78rem code-surface labels at :1061, :1366, :1401 and :2051. #683 (CR-A18-055) covers the --text-muted pairs, link and button colours and the README claim, but not this token, so fixing --text-muted leaves all of these below 4.5:1.

Where.

Evidence (re-verified on 2026-10-09).

Recommended fix. Raise --code-comment to a grey that reaches at least 4.5:1 on #0d1018 (#7a8090 gives 4.8:1), or give the 0.78rem labels their own token, then re-check every text colour used on the code surface in both themes.

Related. #683 — CR-A18-055, the other contrast tokens and the README AA claim.

Acceptance criteria

  • Every text colour used on the code surface reaches 4.5:1 against --code-bg in both themes.
  • The finding is resolved or explicitly closed with a reason.

Found by the September 2026 independent review of ForgeLM against commit cab2947 and re-verified against development at f94595f on 2026-10-09. Code links point at cab2947; line numbers may have moved since. Finding IDs (F-W1-…) are stable references for this backlog.

Ngôn ngữ chính
Python
Star
9
Fork
1
Merge trung bình
17 giờ 14 phút
Pull request đã merge (30 ngày)
17

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

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 HodeTech/ForgeLM

Tất cả issue của HodeTech/ForgeLM

Issue tương tự

Thêm issue về Python

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.