Fix sponsor directory contrast and card treatment in dark mode
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 55/100
- issue の種類
- バグ
- 明瞭さ
- おおむね明確
- 活発さ
- 活発
- 技術スタック
- python
- 領域
- accessibility, design, frontend, testing
調査の方向性
公開されている /sponsors エントリーポイントから始め、_docs/design/design-system.md と core/tests/test_sponsor_directory.py を併せて読みます。既存の featured-card とロゴの挙動を調査し、その後、受け入れ基準に照らして両方のテーマ、レスポンシブ幅、フォーカス状態、ロゴがない場合の処理を確認します。指定された sponsor directory テストと、必要なアクセシビリティおよびブラウザチェックを実行します。保存済みのスポンサー data やロゴファイルを変更せずにカードの可読性が維持されれば完了です。
索引モデルが issue の本文から書いたものです。
説明
Outcome
The public /sponsors directory must remain legible in dark mode while preserving sponsor logos in the form supplied by their owners. The current featured cards force a white card but render body copy with theme-muted colors, producing low contrast.
Normative references:
_docs/design/design-system.md_docs/architecture/database-only-content.mdcore/tests/test_sponsor_directory.py
Product decision
Separate the logo presentation from the card body. A neutral/light logo plate may preserve authored logo colors in either theme; the sponsor name, description, and action use theme-native card/body tokens. Do not recolor logos to compensate for the card contrast bug.
Scope
- Recompose featured sponsor cards on
/sponsorsso logo plate and content surface have explicit, compatible light/dark treatments. - Define theme-appropriate text, link, border, shadow, past-supporter chip, focus, hover, and active states.
- Preserve graceful handling when a logo asset is absent or cannot resolve.
- Regression-check homepage and events sponsor placements if any shared sponsor or card primitive changes.
Non-goals
- Changing sponsor records, order, placement, descriptions, destinations, or lifecycle.
- Editing, filtering, inverting, regenerating, or replacing logo image files.
- Redesigning the homepage, events hub, Studio sponsor editor, or sponsor ingestion.
- Introducing hardcoded sponsor content or a file/runtime fallback.
Dependencies
- No external dependency. Database-owned
Sponsorand placement queries remain authoritative. - Prefer page-local styles. If a shared primitive is changed, its full consumer set becomes required regression scope.
Acceptance criteria
- Featured card body text and links meet WCAG AA contrast in light and dark themes (4.5:1 for normal text, 3:1 for large text); meaningful boundaries and focus indicators meet 3:1 against adjacent colors.
- Each logo is shown unmodified with
object-fit: containinside a bounded, visually distinct plate that remains legible in both themes; transparent, wide, tall, and missing logos do not collapse or stretch the card. - Card body surfaces use design-system theme tokens and never pair a forced white background with dark-theme muted text.
- Sponsor links retain their stored destinations and
target,rel="sponsored noopener noreferrer", accessible sponsor-name label, and visible keyboard focus. - Past-supporter chips have readable foreground/background/border contrast in both themes and wrap without clipping.
- Card, link, and chip hover/focus/active states do not rely on color alone and respect reduced-motion preferences.
- The existing database query/order, missing-logo degradation, page metadata, and database-only-content tests remain unchanged/passing.
- At 1440, 768, 390, and 320 CSS px, long names/descriptions, all logo aspect ratios, and past-supporter chips have no overlap or document-level horizontal overflow. Interactive targets are at least 44 CSS px where the design presents a button-like action.
- If shared sponsor/card CSS or markup changes, homepage and
/eventskeep their accepted light/dark layout and links.
Verification scenarios
Repository
- Run sponsor directory/query, sponsor model/import, design-system shell, shared primitive, and accessibility tests.
- Render fixtures for transparent wide/tall logos, missing/stale logo keys, long copy, and no past supporters; assert one bad logo never takes down the page.
- Run the project contrast/accessibility checker against both themes and record measured pairs.
Browser
- Compare
/sponsorsin light and dark mode at 1440/768/390/320. Inspect the logo plate separately from the card body. - Tab through every sponsor action and confirm focus remains visible without content shifting.
- Toggle reduced motion and exercise hover/focus states.
- If a shared primitive changed, open the homepage sponsor band and
/eventsin both themes and verify content/order/destinations and responsive layout. - Confirm
document.documentElement.scrollWidth === document.documentElement.clientWidthat every width.
Evidence to attach
- Before/after full-page screenshots using
.tmp/screenshots/sponsors-current/as baseline, desktop and mobile in both themes. - Contrast measurements and focused test results.
- 主要言語
- Python
- スター
- 0
- フォーク
- 0
- 平均マージ
- 37分
- マージ済み PR(30日)
- 36
環境構築
- Dockerfile または Docker Compose ファイルあり
- プルリクエストのテンプレートなし
- コントリビューションガイドなし
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
DataTalksClub/website のほかの issue
-
bug infra operations P1 testing
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
DataTalksClub/website#329 ·
メンテナーはふだん 1 日以内に返信
-
bug content data-migration documentation events operations P1
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
DataTalksClub/website#327 ·
メンテナーはふだん 1 日以内に返信
-
bug frontend P0 testing
難易度 2/5 1〜3時間 初心者へのやさしさ 90/100
DataTalksClub/website#300 · コメント 7 件 ·
メンテナーはふだん 1 日以内に返信
-
bug data-migration events P0 testing
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
DataTalksClub/website#295 · コメント 6 件 ·
メンテナーはふだん 1 日以内に返信
-
Show pending evaluation instead of premature project failure and zero scores (CMP drift)対応中かも このイシューにリンクされたプルリクエストがオープン中、またはマージ済みです。 オープンbug courses frontend P1
難易度 4/5 3〜5日 初心者へのやさしさ 35/100
DataTalksClub/website#525 · コメント 2 件 ·
メンテナーはふだん 1 日以内に返信
DataTalksClub/website の issue をすべて見る
似ている issue
-
[dbt] exported dataset keys reference physical columns対応中かも @WilliamKelley が今日担当しました。 オープンneeds-triage
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
apache/ossie-converters#251 ·
メンテナーはふだん 2 日以内に返信
-
cli difficulty: easy enhancement
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
メンテナーはふだん 2 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 62/100
desec-io/desec-stack#1312 ·
メンテナーはふだん 14 日以内に返信
-
needs-triage
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
aws/aws-durable-execution-sdk-python#977 ·
メンテナーはふだん 1 日以内に返信
-
needs-triage
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
flashinfer-ai/flashinfer#9803 ·
メンテナーはふだん 1 日以内に返信