Skip to content

Add Thinking key-concepts page - #174

Merged
alay2shah merged 8 commits into
mainfrom
leonie/thinking-page
Nov 14, 2026
Merged

alay2shah merged 8 commits into
mainfrom
leonie/thinking-page

Conversation

@iamleonie

Copy link
Copy Markdown
Contributor

Summary

  • New Thinking page under Key Concepts: use thinking (Transformers text and image examples, serving with a reasoning parser), separate reasoning from the answer (incl. streaming), token limits, structured output and tool calls, multi-turn and preserve_thinking, switching thinking off, thinking-models table, FAQ.
  • Chat Template page: documents enable_thinking and preserve_thinking for LFM3 and how LFM2.5 thinking-model templates handle reasoning; fixes the LFM2/LFM2.5 anchor.
  • Thinking-model pages (LFM3-1.7B, LFM3-VL-2B, LFM2.5-24B-A2B, LFM2.5-8B-A1B, LFM2.5-1.2B-Thinking) use one standard Reasoning section linking to the new page.

Explains how to use thinking models, separate reasoning from the answer,
switch thinking off where supported, and which models think.
Covers enable_thinking and preserve_thinking for LFM3, and how LFM2.5
thinking-model templates handle reasoning. Fixes the LFM2/LFM2.5 anchor.
Use one template on every thinking-model page and link to the Thinking
page.
@iamleonie
iamleonie requested a review from mlabonne as a code owner November 11, 2026 15:49
@mintlify

mintlify Bot commented Nov 11, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
liquid-docs 🟢 Ready View Preview Nov 14, 2026, 3:27 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

alay2shah added a commit that referenced this pull request Nov 13, 2026
## Summary

Model pages outside the navigation were missing from search and
assistant results, and general recommendations still led with older
models. This audit makes model documentation discoverable and puts LFM3
first in general guidance while retaining useful older models.

- **Search and indexing:** enable indexing for all pages; retain
deprecated model and tool references with warnings. Exclude
docs-maintainer files through `.mintignore` and mark the contributing
page `noindex`.
- **Assistant:** remove the CSS rule that hid the legacy assistant
entry. Add instructions to cite measured performance, use Pipette,
follow exact model-page format links for verified download sizes, and
use published evaluation sources without inventing repositories or
scores.
- **LFM3 guidance:** update the FAQ, use-case evaluation, migration
guide, and troubleshooting. Compare LFM3, LFM2.5, and LFM2; lead with
LFM3 text, vision, audio, and omni models; retain smaller, specialized,
and larger MoE alternatives with explicit reasons.
- **Version-specific instructions:** distinguish LFM3 XML tool calls and
`qwen3_coder` parsing from LFM2/LFM2.5 formats and `lfm2` parsing. Scope
chat templates, LoRA module examples, generation settings, and context
limits to the selected model.
- **Deprecations and examples:** point LFM2-2.6B, LFM2-2.6B-Exp, and
LFM2-Audio directly to current replacements in notices, metadata, and
the deprecations table. Add missing notices to four audio examples, a
newer-model note to the invoice extractor, and warnings to archived
bundling references.
- **Formats and quickstarts:** expose the verified LFM3-Audio and
LFM3-Omni ONNX repositories on their model pages and in the matrix.
Organize ColBERT quickstarts into Retrieval and Reranking, with
library/runtime choices inside Reranking; match the embedding page's
“Sentence Transformers” label.
- **Other audit fixes:** add eight legacy/mistyped URL redirects,
improve embeddings/reranking/RAG terminology, make internal example
links root-relative, and correct the Ollama model-name typo.

## Validation

- Mintlify build validation passed.
- GitHub Check docs and Check link snapshot passed on `1b21fbe`.
- Updated preview content verified for the FAQ, evaluation and migration
guides, troubleshooting, deprecation notice, and ONNX model
buttons/matrix.
- Link snapshot: 233 active URLs verified.
- All 89 distinct internal links and snippet imports in the latest 11
changed files resolve; 20 Python snippets parse.
- New Audio and Omni ONNX repositories verified against their official
Hugging Face pages.
- Updated deprecation notices resolve directly to models that are not
deprecated.

Removing the assistant CSS restriction does not establish that Mintlify
has enabled chat permissions; project configuration still controls
assistant availability.

## Preview review

- [FAQ](https://liquidai-docs-audit.mintlify.site/lfm/help/faqs)
- [Use Case
Evaluation](https://liquidai-docs-audit.mintlify.site/guides/use-case-evaluation)
- [Migration
Guide](https://liquidai-docs-audit.mintlify.site/guides/migration-guide)
-
[Troubleshooting](https://liquidai-docs-audit.mintlify.site/lfm/help/troubleshooting)
-
[Deprecations](https://liquidai-docs-audit.mintlify.site/lfm/help/deprecations)
- [Model
Matrix](https://liquidai-docs-audit.mintlify.site/lfm/models/complete-library#complete-model-matrix)
- [ColBERT
Quickstart](https://liquidai-docs-audit.mintlify.site/lfm/models/lfm25-colbert-350m#quick-start)

## Related work

- #174 and its stacked PR #179 cover Thinking and capability-page
organization.
- #175 covers the Android SDK-to-llama.cpp migration.
- Runtime quickstart rewrites and training/inference notebook
modernization remain follow-up work.

A three-way check against #179 found two small conflicts in
`guides/migration-guide.mdx`: the shared tool-call snippet import and
component invocation. When integrating #179, preserve this PR's LFM3
guidance, adopt its `LFM25ToolCallExample` name with paired JSX tags,
and keep the unused `ChatMLExample` import removed.

---------

Co-authored-by: Leonie Monigatti <iamleonie@users.noreply.github.com>
Co-authored-by: alay2shah <alay0shah@gmail.com>

@alay2shah alay2shah left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed the Thinking page, chat-template guidance, and model-page links, including model-specific reasoning retention, vision serving examples, optional audio reasoning, and thinking-off wording. Build and URL snapshot checks pass.

@alay2shah
alay2shah merged commit 0fe9ffe into main Nov 14, 2026
5 checks passed
@alay2shah
alay2shah deleted the leonie/thinking-page branch November 14, 2026 15:35

This branch was successfully deployed

1 active deployment
staging — 9601cbc6 Deployed Nov 14, 2026 by mintlify[bot]
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.

2 participants