Skip to content

Links are not visually distinguishable in the documentation #30

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
bhouston opened this issue Mar 7, 2025 · 0 comments · Fixed by #33
Closed

Links are not visually distinguishable in the documentation #30

bhouston opened this issue Mar 7, 2025 · 0 comments · Fixed by #33
Labels
bug Something isn't working

Comments

@bhouston
Copy link
Member

bhouston commented Mar 7, 2025

Links are not visually distinguishable in the documentation

Problem

Currently, the links in the documentation are not underlined or colored differently from regular text. This makes it difficult for users to identify what is clickable on the website, negatively impacting user experience and navigation.

Current State

  • Links use the same color as regular text (black in light mode)
  • No underlines or other visual indicators for links
  • Users cannot easily identify clickable elements

Proposed Solution

Make links visually distinguishable by:

  1. Changing link color to blue (a standard for web links)
  2. Consider adding underlines for links, especially in body content
  3. Ensure sufficient contrast between link color and background

Technical Details

This appears to be caused by the CSS customization in src/css/custom.css where all colors were set to black/grayscale. The primary colors need to be updated to include a distinct color for links.

Impact

Improving link visibility will:

  • Enhance user experience
  • Make the documentation more accessible
  • Follow web usability best practices
  • Make the website more intuitive to navigate
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working
Projects
None yet
Development

Successfully merging a pull request may close this issue.

1 participant