Skip to content

docs: generate supported models for llms.txt and docs - #1586

Merged
msluszniak merged 2 commits into
mainfrom
@ms/llms-txt-discoverability
Nov 2, 2026
Merged

msluszniak merged 2 commits into
mainfrom
@ms/llms-txt-discoverability

Conversation

@msluszniak

@msluszniak msluszniak commented Oct 29, 2026 •

Copy link
Copy Markdown
Member

Description

  • llms.txt: header with latest version, backends, precisions and what's new; a "Supported Models" section listing every registry model.
  • New Supported Models docs page (task, backends, precisions, added-in version), also frozen into 0.11.x.
  • Both are generated at build time from models.ts; added-in versions come from release tags.

Introduces a breaking change?

  • Yes
  • No

Type of change

  • Bug fix (change which fixes an issue)
  • New feature (change which adds functionality)
  • Documentation update (improves or adds clarity to existing documentation)
  • Other (chores, tests, code style improvements etc.)

Tested on

  • iOS
  • Android

Testing instructions

  • cd docs && yarn build, then check build/llms.txt and /docs/fundamentals/supported-models.

Screenshots

Related issues

#1581

Checklist

  • I have performed a self-review of my code
  • I have commented my code, particularly in hard-to-understand areas
  • I have updated the documentation accordingly
  • My changes generate no new warnings

Additional notes

Docs CI now checks out full history (blob:none) to read the tags.

Parse the models registry at docs build time into a Supported Models page
and an llms.txt section, and add the latest version, backends and
positioning to the llms.txt header. Refs #1581.
Walk release tags in date order to find the first release that shipped each
registry entry, with a fixed alias table for the pre-0.10 constant names.
Docs CI checks out full history (blobless) so the column is never dropped.
@msluszniak msluszniak self-assigned this Oct 29, 2026
@msluszniak msluszniak added the documentation Improvements or additions to documentation label Oct 29, 2026
@msluszniak
msluszniak requested a review from barhanc October 30, 2026 13:27
@msluszniak
msluszniak merged commit 7a8717f into main Nov 2, 2026
7 checks passed
@msluszniak
msluszniak deleted the @ms/llms-txt-discoverability branch November 2, 2026 11:51
msluszniak added a commit that referenced this pull request Nov 2, 2026
## Description

- Docs deploy fails since #1586: the deploy action re-adds `origin` and
re-fetches inside the `blob:none` clone, which dies with `pack has N
unresolved deltas`.
- Deploy now runs in a separate job from a plain checkout; deploy action
bumped from v3 (2020) to v4.

### Introduces a breaking change?

- [ ] Yes
- [x] No

### Type of change

- [ ] Bug fix (change which fixes an issue)
- [ ] New feature (change which adds functionality)
- [ ] Documentation update (improves or adds clarity to existing
documentation)
- [x] Other (chores, tests, code style improvements etc.)

### Tested on

- [ ] iOS
- [ ] Android

### Testing instructions

- After merge, Publish to GitHub Pages should pass and update
`gh-pages`.

### Screenshots

### Related issues

### Checklist

- [x] I have performed a self-review of my code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have updated the documentation accordingly
- [x] My changes generate no new warnings

### Additional notes
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants