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

[P2] Distinguish inline documentation links without relying only on color

Open Beginner friendly
#74 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
84/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
csharp, css, html

Research direction

Start with docs/css/style.css:37 and compare the prose links referenced in docs/learn.html:126 and docs/examples.html:6. Check the pages with axe's link-in-text-block rule, then verify links are distinguishable before hover and when keyboard-focused. Done when the axe checks pass and navigation and buttons remain visually coherent.

Written by the indexing model from the issue text.

Description

documentation

Audit of main at 33775b35ce39b259cc6a4ea33db6216aba19d702 on 2026-10-08. Priority P2; area: Documentation.

Problem

Inline prose links are distinguished only by a color too similar in luminance to surrounding text. Users with color-vision limitations cannot reliably discover them.

Evidence / reproduction

axe link-in-text-block flags six links on desktop learn.html and one on examples.html. The examples link has 1.21:1 contrast against surrounding text and no underline; required distinction is an additional visual cue or adequate color contrast.

Source: docs/css/style.css:37, docs/learn.html:126, docs/examples.html:6.

Suggested change

Use an underline or another persistent noncolor cue for prose links, with clear hover and keyboard-focus styles.

Acceptance criteria
  • axe link-in-text-block checks pass.
  • Links are distinguishable before hover and under keyboard focus.
  • Navigation/buttons remain visually coherent.
Dominant language
C#
Stars
1
Forks
0
Avg merge
16h 35m
Merged PRs (30d)
1

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 evilz/TermBlade

All issues in evilz/TermBlade

Similar issues

More C# issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.