xonecas.io
8356
Wx

www-xonecas-io / files

www-xonecas-io / tickets / 1036-seo-agent-accessibility.md

3.1 KB
1---
2id: 1036
3title: SEO/Agent accessibility
4type: feature
5status: inbox
6priority: p2
7created: 2026-11-08T05:16:54Z
8updated: 2026-11-08T20:51:08Z
9source: human
10moves: 2026-11-08T05:19:58Z inbox todo drag; 2026-11-08T05:21:38Z todo doing drag; 2026-11-08T05:40:30Z doing review agent; 2026-11-08T16:01:19Z review todo drag; 2026-11-08T20:16:34Z todo doing drag; 2026-11-08T20:51:08Z doing inbox drag
11area: site
12---
13
14Lighthouse best practices, llms.txt, etc.
15
16https://web.dev/articles/ai-agent-site-ux for reference
17
18## Notes
19
20- 2026-11-08 05:40Z (agent): Done. Lighthouse (v12, against the dev server, light mode):
21  
22  | page | accessibility | SEO | best practices |
23  |---|---|---|---|
24  | / | 90 → 100 | 91 → 100 | 79 (only HTTPS) |
25  | /projects/ | 91 → 100 | 91 → 100 | 79 (only HTTPS) |
26  | /projects/irvc/ | 91 → 100 | 91 → 100 | 79 (only HTTPS) |
27  | /activity/ | 100 | 100 | 79 (only HTTPS) |
28  | /projects/irvc/commits/ | 100 | 100 | not run |
29  | a file page (irvc main.go) | 96 | 100 | not run |
30  
31  The two best-practices failures are is-on-https and redirects-http. They come from the dev server on plain http, and Caddy will serve the real site over HTTPS.
32  
33  What changed:
34  - Every page has a meta description, plus og:title, og:description and og:site_name. head now takes (list title description). Project pages use the project's description, and the others get a line generated from their data, e.g. 'Every public project by Sean Caetano Martin (xonecas) since 2011: 82 projects and 2,775 commits, to browse and clone.'
35  - New files written by the build (internal/site/seo.go):
36    - /robots.txt: allows all and points to the sitemap.
37    - /sitemap.xml: home, /projects/, /activity/, and the 82 project pages with lastmod set to their last commit.
38    - /llms.txt: in the llms.txt format, a summary line, the three main pages, how project URLs and clones work, then every project with its description, dates, main language and topics, newest first.
39    - BaseURL https://xonecas.io is a const there.
40  - Contrast (WCAG AA 4.5:1):
41    - --color-soft in light mode went from 60% to 70% ink. It was 4.1–4.5:1 on paper, card and grey.
42    - The light accent went from #a8461f to #9e411c. It was 4.44:1 on the grey head-commit bar.
43    - Code line numbers went from 40% to 55%. They were 3.4:1.
44    - Dark mode is untouched.
45  - The search input has aria-label and starts with aria-expanded=false, which its combobox role requires.
46  - The 'N commits' link on project pages is underlined. It only differed from the text around it by colour.
47  - The /projects slider inputs are 24px tall, up from 20px, the minimum target size.
48  
49  From the web.dev article (agent-friendly sites): the site already uses semantic links, buttons and forms, cursor:pointer, and stable layouts. The search input now has a name, and the dropdown is a proper combobox and listbox. I didn't do WebMCP, which the article calls experimental.
50  
51  Not done: code line-number links stay 20px tall (target-size on file pages). Making them 24px would loosen every code view. No dark-mode audit, since 1039 is about dark colours. No canonical links. No schema.org data.