Skip to content

Links are not visually distinguishable in the documentation #30

@bhouston

Description

@bhouston

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions