influxdata / influxdata/docs-v2

seo: "Go" client library links flagged as non-descriptive link text

Open Beginner friendly
#7,545 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
JavaScript
Stars
82
Forks
326
Avg merge
1d 1h
Merged PRs (30d)
82

Description

## Problem

A Lighthouse 13.2.0 audit of https://docs.influxdata.com/influxdb3/enterprise/ (2026-07-20) failed the `link-text` audit ("Links do not have descriptive text" — 3 links found). SEO scored **83**; this and the now-fixed `crawlable-anchors` failure were the only failing SEO audits.

## Lighthouse findings

Links with the text **"Go"** (the language name collides with the generic call-to-action word Lighthouse flags):

| Link text | Destination |
| --- | --- |
| Go | `/influxdb3/enterprise/reference/client-libraries/flight/go-flight/` |
| Go | `/influxdb3/enterprise/reference/client-libraries/v3/go/` |
| Go | `/influxdb3/enterprise/reference/client-libraries/v2/go/` |

These appear in the client-library navigation/menus, so the same pattern exists across other products' menus (`data/` menus / sidebar nav for client libraries).

## Proposed fix

Options, in preference order:

1. Rename the menu entries to be self-descriptive, e.g. "Go client library" / "Go (Flight)" — also helps screen-reader users navigating by link list.
2. If the short visible label must stay, add context via `aria-label` (e.g. `aria-label="Go client library"`) in the menu template — Lighthouse uses the accessible name for this audit.

## Reproduce

Run Lighthouse (SEO category, mobile) against the URL above and inspect the `link-text` audit.

Related: other findings from this audit are fixed on branch `claude/influxdb-docs-lighthouse-chphcn` or tracked in the perf/a11y issues filed alongside this one.

Contributor guide

No contributing guide indexed for this repository

Research direction

Inspect the client-library navigation and sidebar menu templates under data/, focusing on the entries linked from the three listed URLs. Run the Lighthouse SEO mobile audit against the Enterprise page, update the visible or accessible link names so each identifies the Go client library, and confirm the link-text audit passes.

Written by the indexing model from the issue text.

Assessment

Tech stack
html, javascript
Domain
accessibility, documentation, web-dev
Issue type
Bug
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
70/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.