Skip to content

docs: rewrite llms.txt and simplify the install steps - #245

Merged
kolkov merged 2 commits into
mainfrom
docs/llms-txt
Nov 8, 2026
Merged

kolkov merged 2 commits into
mainfrom
docs/llms-txt

Conversation

@kolkov

@kolkov kolkov commented Nov 8, 2026

Copy link
Copy Markdown
Contributor

Two docs changes about how people and agents find and install ui.

llms.txt was a stub: it said ui is part of the GoGPU ecosystem and linked three pages, so an agent reading it learned nothing about what the toolkit does. The new file follows the llmstxt.org layout:

  • a short description: widgets, signals-based state, layout, design systems, the GPU backends, the layer-tree compositor, platforms, zero CGO, pre-1.0 status;
  • how to add ui to a project;
  • links to pkg.go.dev, README, Getting Started, AGENTS.md, ARCHITECTURE, the render pipeline doc, CHANGELOG and ROADMAP;
  • the minimal app in the README Quick Start, plus hello and gallery;
  • the GoGPU ecosystem map at gogpu.dev/llms.txt.

It has no version numbers, so it does not go stale between releases.

The README and the getting-started guide told users to go get gogpu and gg at @latest next to ui. When those tags are ahead of the ui release, the build mixes dependency versions that don't compile together, which is what #239 ran into. Both now say to add ui and run go mod tidy, which keeps gogpu and gg at the versions the ui release was built with.

I checked every link, and the Quick Start snippet builds with GOWORK=off against the released dependencies.

The old file only said the module is part of the GoGPU ecosystem.
It now says what ui does, how to add it without mismatched
dependency versions, and links the guides and key examples.
README and the getting-started guide told users to go get gogpu@latest
and gg@latest next to ui. When those tags are ahead of the ui release,
the build mixes dependency versions that do not compile together.
Adding ui and running go mod tidy keeps them at the versions the ui
release was built with.
@codecov

codecov Bot commented Nov 8, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@kolkov
kolkov merged commit a6f05fb into main Nov 8, 2026
9 checks passed
@kolkov
kolkov deleted the docs/llms-txt branch November 8, 2026 07:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant