A Dead-Link Replacement Queue for Downloadable Supplier Manuals
A product page links to a supplier manual, and the link no longer works. The tempting repair is to find a similar manual and paste it in. That is risky: a manual for a neighbouring model may describe different connections, ratings or procedures. This article proposes, conditionally, a replacement queue where every candidate must pass a model match decision before it replaces anything.
Principle
A missing manual is better than a wrong manual. The queue should make it easy to leave a product with a clear "manual currently unavailable" note, and hard to attach a manual whose model match is unclear.
Primary artifact: model-match decision queue
If adopted, each broken link becomes one queue item.
| Column | Meaning |
|---|---|
| Product and exact model code | As held in the catalogue |
| Broken URL and date noticed | For history |
| Candidate manual | Title and location of what was found |
| Model code on candidate | Copied exactly from the document |
| Match level | exact, family, or unclear |
| Decision | attach, hold, or no manual |
| Decided by, date | Accountability |
Match levels would be defined narrowly. Exact means the document names the product's full model code. Family means it covers a range that the model code appears to belong to, but does not name it. Unclear means anything else.
Decision rules
- Exact: attach, after confirming the document opens and is readable.
- Family: do not attach automatically. A second person could check whether the document explicitly lists the model, or the team could ask the supplier. Until then, hold.
- Unclear: hold, and keep searching or mark no manual.
- Different revision or year of the same model: treat as family unless the supplier states the versions are interchangeable.
Branching choices
If the supplier supplies a new link, still compare the model code on the document. If the document covers several models, attach it only if the product's code is named. If only a translated version exists, record the language so customers are not surprised. If nothing is found, show a plain note, such as "Manual not currently available", and keep the item in the queue for a later recheck.
Hypothetical worked example
Imagine product "Model KR-210B" has a dead link. Three candidates turn up. The first is titled "KR-210B Installation Guide" and names KR-210B on its cover: exact, attach. The second is "KR-200 Series Guide", which does not list the 210B: family, hold. The third is "KR-210" without the B suffix: unclear, because the suffix might mean a different variant; hold. The product receives the first manual only. The other two items remain visible in the queue with reasons, so nobody repeats the research.
Stop conditions
Stop and escalate if a candidate manual contradicts the product page on a key detail, if the only candidate comes from an unverified source, or if the catalogue's model code itself looks wrong. Do not bulk-attach manuals to many products from one family document without checking each code.
Acceptance checks
- Every attached manual has the exact model code recorded next to the match level.
- No queue item is marked attach with a match level other than exact.
- Items on hold show the reason and a recheck date.
- The product page never links to a manual whose decision is hold or no manual.
- A second reviewer picking five attached items at random can find the model code in each document within a minute.
- After repair, each fixed link opens, and the queue count of open items falls by exactly the number resolved.