Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le 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)

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

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
66/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
css
Ambito
accessibility, design

Direzione di ricerca

Inizia dal token --code-comment in site/css/style.css:56 e dal blocco del tema chiaro a :115, che mantiene --code-bg scuro. Le regole del colore del testo sulle superfici di codice si trovano a :1061, :1095, :1366, :1390, :1401 e :2051. Verifica il contrasto di #7a8090 rispetto a #0d1018 (la issue riporta 4,8:1), quindi conferma che ogni colore del testo elencato raggiunga 4,5:1 in entrambi i temi. Coordinati con #683 (CR-A18-055), che copre i token --text-muted correlati.

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

Descrizione

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.

Lingua principale
Python
Stelle
9
Fork
1
Merge medio
4h 3m
PR unite (30g)
3

Preparare l'ambiente

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

Tutte le issue di HodeTech/ForgeLM

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.