Build1 distinct publisher3 min readUpdated
A worked example from a dev.to post shows a fixed-size split severing "unless defective" from a refund rule. Retrieval still ranks the mutilated chunk first, and no component reports a fault.
The Engineer · Build desk

Compiled by The EngineerSomething wrong?How this is made
Retrieval did its job in that refund example, which is exactly why the bug survives review. The chunk handed to the model is about sale items and contains the phrase the user asked about [4], so anyone auditing the retrieval step marks it relevant. The clause that reverses the rule sits in a chunk that scored lower and was never sent [5]. Every component reports success and the answer is still wrong [6].
That is a different class of failure from the ones a pipeline is instrumented for. A missing document shows up as an empty result set. A decapitated clause shows up as a confident sentence.
The reason you cannot buy your way out with a bigger window is in the embedding itself: a chunk collapses to one point standing for the average meaning of everything inside it [8]. The post suggests 200 to 500 tokens as a starting band for prose documentation [12], which means the default teams admit to, 500 tokens [1], already sits at the ceiling of the recommended range [3]. Go to 2,000 tokens, four times that ceiling [2], and a chunk spanning refunds, shipping and warranties lands at a midpoint that a narrow question is only near-ish, where a tighter and less relevant chunk can outrank it [10]. Three of those in a prompt is 6,000 tokens spent to answer a question about one sentence [11]. Go small instead and you get sharp retrieval with dangling pronouns: "It must be unopened" carries nothing once "it" was named a paragraph earlier [9].
Overlap is the standard hedge, repeating the last 10 to 20 percent of the previous chunk so a straddling sentence survives whole somewhere [13]. Price it properly. Fifteen percent on a 500-token chunk is 75 duplicated tokens in every chunk [1], re-embedded and re-stored on each ingestion run [14], and the duplicates retrieve as a pair, so one slot in the top k holds a copy [15]. The author's own verdict is that this patches arbitrary cuts without making the cuts less arbitrary [16].
The alternative is not a cleverer algorithm. Documents arrive with boundaries their authors already declared: headings, sections, paragraphs, list items, table rows [17]. A splitter that honours them is doing less work than one counting characters, not more.
What the post pushes to its final section is the measurement method [18], and that is where teams will stall. Standard retrieval scoring rewards the truncated chunk, because by every lexical and semantic measure it is on topic. Until an eval separates a chunk that is about the question from a chunk that is sufficient to answer it, chunk size remains a matter of taste with a policy commitment attached.
Follow any of these and your For You feed starts watching them — no settings page required.
Ranked by verification strength, evidence, and original report placement.
A heading-aware chunker would have kept the whole "Refund policy" section together as one chunk so the model saw both the rule and the exception: same stack, same models, correct answer.
Documents are not streams of characters but carry structure the author already provided: headings, sections, paragraphs, list items, table rows; the best chunking approach is described as barely an algorithm, being respect for that structure.
Small chunks give precise retrieval but may not carry enough surrounding context to answer; "It must be unopened" is useless when "it" was defined a paragraph earlier.
A 2,000-token chunk covering refunds, shipping and warranties embeds into a mushy midpoint of all three topics, so a precise question about restocking fees is near-ish that blob but not close to anything, and an unrelated but tighter chunk can outrank it.
There is no universally correct chunk size; for most prose documentation somewhere between 200 and 500 tokens is described as a sane starting point, followed by measurement.
Fifteen percent overlap means embedding and storing 15 percent more tokens, forever, on every re-ingestion.
Evidence-backed comparisons of source perspectives and observed adoption signals. Read the methodology
Which Builder, Operator, and Investor concerns the observed source mix emphasized—not a truth score.
Evidence, demonstrated adoption, hype gap, incentives, and confidence are assessed independently, each on its own current evidence. How these are measured.
One illustrative post, no measurement
The mechanism is documented clearly and self-consistently inside a single dev.to post: a quoted sample policy, the exact truncated chunk it produces, and the resulting wrong answer. But the retrieval ranking, the wrong generation and the claimed elimination of mid-thought failures by heading-aware splitting are all narrated rather than measured - no embedding model, index, similarity scores, evaluation set or before/after numbers appear - and the post's own measurement guidance is deferred beyond the captured text. Single publisher, no corroboration, so evidence is limited to a plausible worked illustration.
No adoption data in sources
The supplied source reports no release, deployment, benchmark run, pricing or usage disclosure. It notes only in passing that mainstream frameworks include recursive character splitting and markdown-header splitters, without naming a framework, version, user count or deployment. There is no basis to score adoption without inferring facts the material does not contain.
Modestly overstated headline leverage
The underlying mechanics - averaged embeddings, boundary truncation, overlap costs, near-duplicate retrieval - are standard and stated carefully, including the explicit caveat that no universally correct chunk size exists. The overstatement is narrower: chunking is billed as 'the highest-leverage, least-discussed decision' in a RAG pipeline and heading-aware splitting is said to eliminate an entire class of failures, while the supporting artifact is one hand-constructed example with no retrieval evaluation, and the sweeping characterization of how teams chunk rests on anecdote. Slightly positive rather than large, because the prescriptions themselves are cheap, reversible and internally consistent.
Publisher interest undisclosed
The material gives no disclosure of commercial interest: the article is a technical explainer on a community platform, names no vendor, product, framework or sponsor, and makes no purchase recommendation in the captured text. The publishing account handle in the URL hints at an organizational author, but the supplied sources contain nothing about who operates it or whether a product is being sold, and inferring an incentive from a handle alone would not be evidence.
Mechanism credible, breadth unverified
Confidence is moderate. The causal chain is easy to accept because it is deterministic and familiar - a character-count splitter can cut mid-clause, an embedding averages what remains, and a lexically matching fragment can outrank the chunk holding the exception - and the failure-is-silent point follows from the architecture rather than from data. What cannot be judged from this material is how often it occurs in production, how much heading-aware chunking actually recovers, or whether the author's cost figures reflect real pipelines, since adoption evidence is absent, only one publisher is present, and the promised measurement section is missing.
build
A docs bot that refuses to answer is working: the case for an evidence gate over a bigger window1 distinct publisher
build
Retrieval Is Not A Cheap Agent, And An Agent Is Not A Smart Retriever1 distinct publisher
build
A RAG Pipeline in 200 Lines of TypeScript, and the Parts the Frameworks Hide1 distinct publisher
build
Allow-list the closed set, block-list the open one: 193 thin geo pages, one gate1 distinct publisher
Distinct publishers with included, body-backed reporting in this cluster.
dev.to
1 article · August 23, 2026