Skip to content

docs: keep llms.txt in sync via AGENTS.md; link docs from package docstring - #36

Merged
micahpw merged 1 commit into
mainfrom
docs/agent-discoverability-followups
Aug 4, 2026
Merged

docs: keep llms.txt in sync via AGENTS.md; link docs from package docstring#36
micahpw merged 1 commit into
mainfrom
docs/agent-discoverability-followups

Conversation

@micahpw

@micahpw micahpw commented Aug 4, 2026

Copy link
Copy Markdown
Collaborator

Summary

Two small follow-ups from #33:

  • AGENTS.md: instructs contributors to update docs/source/_llms_root/llms.txt alongside doc changes, since it's hand-written rather than generated from the toctree and will otherwise silently drift.
  • src/gat/__init__.py: adds the docs URL to the top-level package docstring, so import gat; help(gat) surfaces it for an agent that's already imported the package without having read README/PyPI.

Other discoverability paths were already in place, verified rather than assumed:

  • pyproject.toml's [project.urls] → surfaced on the PyPI project page's "Project links" sidebar
  • GitHub repo homepage/topics → already set to the docs URL with relevant keywords

🤖 Generated with Claude Code

…e docstring

AGENTS.md now tells contributors to update llms.txt alongside doc
changes, since it's hand-written rather than toctree-generated. The
top-level gat package docstring gets a docs link too, for an agent
that's already imported the package but hasn't read README/PyPI.
@micahpw
micahpw merged commit dee1a08 into main Aug 4, 2026
7 checks passed
@micahpw
micahpw deleted the docs/agent-discoverability-followups branch August 4, 2026 17:37
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