Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

docs(site): Mermaid edge-label contrast on Architecture and a table header on How it compares

Open Beginner friendly
  • Is something wrong?
#1,132 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
62/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
javascript, markdown
Domain
accessibility, documentation

Research direction

Start with the Mermaid theme configuration in website/astro.config.mjs and the diagrams in docs/ARCHITECTURE.md, then check the dark-theme edge label colours against the 4.5:1 ratio. Next, open docs/COMPARISON.md and find the table with a data cell that has no header. Done means Lighthouse reports 100 for accessibility on Architecture in light and dark mode, the How it compares page has no td-has-header failure, and astro build passes its link check.

Written by the indexing model from the issue text.

Description

documentation

Background

The Lighthouse 12.8.2 re-audit for #1130 scored every dashboard page and most docs pages at 100. Two docs pages still fail:

  • Architecture scores 96 before and after #1130. The Mermaid dark theme draws edge labels as #cccccc on #585858, a contrast ratio of 4.43:1. WCAG AA needs 4.5:1 for normal text.
  • How it compares scores 100 but reports a td-has-header failure on one table: a data cell has no associated header.

Change required

  • Set Mermaid theme variables for the dark theme (edge label text or background) so the contrast is at least 4.5:1. Check the light theme too.
  • Find the table that fails td-has-header on the comparison page, and give every data cell a header, for example by adding the missing header cell or a scope.

Acceptance criteria

  • Lighthouse accessibility score of 100 on the Architecture page in light and dark mode.
  • No td-has-header failure on the How it compares page.
  • astro build link check passes.

References

  • #1123, #1130
  • website/astro.config.mjs, docs/ARCHITECTURE.md, docs/COMPARISON.md
Dominant language
Java
Stars
35
Forks
7
Avg merge
9h 37m
Merged PRs (30d)
148

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from devops-thiago/ThrillhouseBot

All issues in devops-thiago/ThrillhouseBot

Similar issues

More Java issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.