All knowledge base guides

FAQS & CATALOGS / FIELD GUIDE

Make product FAQs answer the right question

Keep product identifiers, exceptions, and versions attached to the answer.

5 min read · SaveMyToken editorial · Documentation reviewed 2026-10-05 · Build in your own stack

STEP 01

Make each answer self-contained

An isolated sentence such as “It supports two devices” is ambiguous when several products share an index. Include the product and question in the same passage.

  1. Keep each question with its answer, product name, version, and important limitations.
  2. For tables, preserve the column headers and units with each row. Inspect extracted text instead of assuming the PDF layout survived.
  3. For sums, inventory counts, or joins, use a structured query workflow. This text-retrieval recipe does not validate calculations over tables.

STEP 02

Test wording and meaning

Use Hybrid Search as a baseline and try a keyword-heavier balance for identifiers. Treat suggested weights as experiments, not measured recommendations for your collection.

  1. Try the exact product code, a partial description, and a natural-language question about the same item.
  2. Compare the returned product and evidence before changing the answer model.
  3. When multiple versions coexist, add version metadata and use an appropriate filter. Ask for clarification if the intended version is unknown.

STEP 03

Use a discriminating test pair

Example test design: ask the same compatibility question about two different products whose answers differ. Substitute products and verified answers from your own source documents.

  1. Record which document and version should support each answer.
  2. Pass only if both the product identity and its limitation are preserved.
  3. Add an unknown product code. The assistant should request clarification or say the evidence is missing rather than borrowing another product's answer.
Give your changes a fair test.

Use the same questions, inspect the evidence, and record what changed.

Open comparison worksheet