Repository navigation
[Docs] Correct the four front-door claims the last day of measurement invalidated - #23
Merged
Merged
Conversation
Four fixes to pages a first-time reader meets before anything else. 1. DIRIGO.md said the batch_after threshold "was not swept" and that the router's switch back was unmeasured. Both were measured on 2026-11-14: the switch back costs a conversation 1.9 s per re-open, so the value stays at 4, and sweeping it found that the config key was never read (fixed in b906f0b). The page now says that instead of listing a limit that no longer exists. 2. README's change table said the cache goes off "for runs of single-shot prompts" without the number, so a reader could think one request flips it. It says four, and what the other settings cost. 3. The same table claimed the routing is worth -12..-22 % without saying at how many clients: it is 1-4, nothing at 8. 4. Both quick starts named data/expert-profile.bin without saying which model shape it fits. The profile is matched on the expert count, not the quantization: 48x512 for the full model, 48x256 for the pruned Coder - and the wrong one stops the engine with "it is a profile for a different model", which reads like a corrupted pack. Verified from the IQ3_XXS GGUF's own metadata (expert_count 512) before writing it. Also repairs the one dead link a reader could hit: docs/HOW_IT_WORKS.md pointed at ../README.md#how-does-it-work, a heading the README rewrite removed. A second candidate (MODELS.md#a-big-graphics-card-and-little-ram) was left alone after checking: that anchor resolves, and my first attempt at "fixing" it would have broken a working link.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem and result
The front page and the first-run path were rewritten on 2026-11-13; a day of measurement since then has made four
statements in them false, imprecise, or a trap. All four are on pages a newcomer reads before anything else.
DIRIGO.mdlisted a limit that no longer exists — "the--conv-route-batch-afterthreshold was not swept" andthe switch back was unmeasured. Both were measured on 2026-11-14 (§7): the switch back costs a conversation 1.9 s
per re-open, so 4 stands, and sweeping it revealed the config key was never read (fixed in
b906f0b5).README.mdgave no threshold — "runs of single-shot prompts" reads as "one request flips it". It is four.data/expert-profile.binwithout saying which model shape it fits. The profile ismatched on the expert count, not the quantization: 48×512 for the full model, 48×256 for the pruned Coder — and
the wrong one stops the engine with
it is a profile for a different model, which reads like a corrupted pack.Plus one dead link a reader could actually hit:
docs/HOW_IT_WORKS.mdpointed at../README.md#how-does-it-work, aheading the README rewrite removed.
Related discussion
Approach
Audited the ten front-door pages for links, anchors, and every claim touching
batch_after, the cache switch, TTFTnumbers,
--expert-profileand PLE; fixed only what was actually wrong.Validation
Passed:
48layers,expert_count = 512), so "IQ2_/IQ3_/Q2_0 →expert-profile.bin" is grounded; the Coder packs' headers are 48×256.stripped, spaces → hyphens, explicit
<a name>honoured).Failed:
MODELS.md#a-big-graphics-card-and-little-ramto#pick-by-memorybecause my slug function collapsed the double hyphen GitHub produces when a
/is removed from"History / older measurements". The anchor resolves; the change is reverted, and the checker now uses GitHub's rule
(each space → one hyphen, no collapsing).
Not run:
Limits
bench/results/andapps/host/docs/still carrytheir historical dead links by design (they are evidence, not navigation).