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.