Best practices

Writing pages the assistant can quote

Plain, specific, one answer per question.

The assistant quotes your pages. Write them so a quote sounds right.

  • One fact per sentence. "Returns are accepted within 30 days of delivery." Not a paragraph that winds around it.
  • Numbers, not ranges, where you can. "Ships in 2 business days" beats "ships fast".
  • Say what is not covered. "Sale items cannot be returned." The assistant will say it too, kindly.
  • Do not contradict yourself. If the FAQ says 30 days and the policy page says 14, the assistant may pick either. Fix one.
  • Name things the way customers do. If customers say "gift box", do not only call it "presentation packaging".